flock-back - GitLite

KO | EN

gitlite — search

#javascript #react #ai #llm #go #android #rust #linux #macos #java #windows #kubernetes #ios #mcp

flock-back

(★ 208)

Wardriving tool for finding Flock Cameras.

File Explorer

Download Latest Version (.zip)

- - release.yml
- - .gitignore
- bari.json
- converter.py
- manuf_old.txt
- manuf_ring_mast4r.txt
- mk_manuf.txt
- ble.md
- jamming.md
- lte.md
- references.md
- wifi.md
- - style.css
- - live.json
- - dashboard.js
- index.html
- README.md
- test_1.png
- test_2.png
- test_3.png
- test_4.png
- arch_gps_setup.txt
- ble_adapter_commands.txt
- debian_kali_gps_setup.txt
- fix_sudo.txt
- flock_cameras_script.txt
- setup_ble.txt
- .gitignore
- database.py
- deappreciated.py
- flock_finder.py
- kismet_watcher.py
- main.py
- mode.py
- server.py
- signatures.py
- vars.py
- wardriver.py
.gitignore
LICENSE
README.md
requirements.txt

# Installation Guide

1. Get the code

git clone https://github.com/NSM-Barii/flock-back

Downloads the entire project code from GitHub to your computer.

cd flock-back

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

APT (Debian/Ubuntu 계열) Built into Debian/Ubuntu-based Linux distributions.

sudo apt install tshark -y

Installs directly from the APT package repository (Debian/Ubuntu-based).

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install -r requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

python3 -m venv venv

Runs the Python script (or module).

pip install -r ../requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FlockBack — AI Camera Detection Toolkit
![Flock-Back Banner](https://github.com/user-attachments/assets/81829f0c-b241-4099-addd-c09e106f187a)

> **v2.0** — Newer Flock cameras no longer advertise via BLE. They now reveal themselves through **WiFi probe requests**. FlockBack detects both, running BLE and WiFi sniffers in parallel so no camera gets missed regardless of firmware version.

Python tool for detecting **AI-powered license plate reader (LPR) cameras** (Flock Safety, Raven, Penguin, PigVision, etc.) while wardriving. Cameras are detected passively — they announce themselves, you just need to be listening.

**Features:**
- **WiFi probe request + beacon capture** — primary detection method for newer Flock firmware
- **BLE scanning** — catches older units still advertising
- Channel hopping with configurable delay, hop list, and presets
- Frame count, sequence number, and subtype logging per device
- All finds saved to `flocks.json`, packet mode hits to `packets.json`

---

## Dependencies

**Python 3.10+**, and the following system packages:

**BlueZ (Bluetooth):**
```bash
sudo apt update && sudo apt install bluez bluez-tools bluez-firmware -y
sudo systemctl enable bluetooth && sudo systemctl start bluetooth
systemctl status bluetooth
```

**tshark (Wi-Fi packet capture):**
```bash
sudo apt install tshark -y
```
> During install, select **Yes** when asked to allow non-superusers to capture packets, or run with `sudo`.

**Python packages:**
```bash
pip install -r requirements.txt
```

> **Troubleshooting Bluetooth:** See `setup/setup_ble.txt` for additional configuration help.

---

## Quick Start

**Install:**
```bash
git clone https://github.com/NSM-Barii/flock-back
cd flock-back/src
python3 -m venv venv
source venv/bin/activate
pip install -r ../requirements.txt
```

**Run:**
```bash
# BLE-only mode
sudo venv/bin/python main.py

# BLE + Wi-Fi mode (requires monitor mode adapter)
sudo venv/bin/python main.py -i wlan1

# Verbose mode (show all devices)
sudo venv/bin/python main.py -i wlan1 -v

# Packet mode (continuous logging of repeat Flock hits)
sudo venv/bin/python main.py -i wlan1 -p
```

---

## Options

| Flag | Description | Default |
|------|-------------|---------|
| `-i` | Monitor-mode WiFi interface | None |
| `-b` | Bluetooth adapter | `hci0` |
| `-w` | Wardriver mode — auto-detects all monitor adapters, splits channels by band, hops across 2.4GHz + 5GHz | Off |
| `-k` | Kismet mode — polls Kismet REST API every 10s and runs sig matching against all seen devices. Channel hopping handled by Kismet, not flock-back. Use with `-w` when running alongside Dooku | Off |
| `-nb` | Disable BLE scanner | Off |
| `-p` | Packet mode — keep printing/saving repeat Flock hits | Off |
| `-v` | Verbose — show non-Flock devices | Off |
| `-g` | GPS serial port — **not implemented yet, do not use** | None |
| `-bs` | BLE scan window in seconds | `5` |
| `-delay` | Channel hop dwell time in seconds | `0.125` |
| `-hops` | Custom channel list (e.g. `-hops 1 6 11`) | See below |
| `-preset` | Channel preset: `2.4`, `5`, or `all` | `all` |
| `-h` | Help menu | — |

**Default hop list:** `1 6 11 36 40 44 48 149 153 157 161`

**Presets:**
- `2.4` — channels 1-11 (2.4GHz only, recommended for wardriving)
- `5` — 5GHz only (36, 40, 44, 48, 149, 153, 157, 161)
- `all` — default list

**Common combos:**
```bash
# Standalone wardriving — flock-back handles everything
sudo venv/bin/python main.py -w

# Kismet mode — run alongside Kismet (e.g. via Dooku)
sudo venv/bin/python main.py -w -k

# Kismet mode, no BLE
sudo venv/bin/python main.py -w -k -nb
```

---

## Output

Finds are saved to `database/flocks.json` (newline-delimited JSON):
```json
{"time_stamp": "05/01/2026  -  03:58:25", "type": "ble", "rssi": -86, "mac": "58:8E:81:FC:F5:51", "local_name": "FS Ext Battery", "manufacturer": false, "uuids": false}
{"time_stamp": "05/01/2026  -  04:15:59", "type": "wifi", "rssi": -84, "mac": "d8:f3:bc:7d:c1:a9", "ssid": "<MISSING>", "vendor": "Liteon Technology Corporation", "frequency": "5745", "encryption": "unknown", "channel": "149", "subtype": "0x0004", "seq": "1195", "frame_count": 2}
```

Packet mode repeat hits are saved to `database/packets.json` in the same format.

---

## In The Wild

> **[Dooku](https://github.com/nsm-barii/dooku)** — a hardened portable wardriving rig (Raspberry Pi 5, multiple monitor-mode adapters, runs headless) built around flock-back. Boots up, creates its own AP, and runs flock-back automatically. If you want to see this tool deployed in the real world, that's where to look.

---

## Research

Probe request discovery by: @jakeswiz

Signatures by: @colonel_panic_hacks

Program: GitHub.com/nsm-barii/flock-back

---

This program, originally created in December of last year, was made to find the ever growing threat of Flock cameras appearing in America.

Originally it was made and based primarily off of finding these Flock cameras by wardriving and sniffing mainly with BLE and comparing the BLE packets against a list of BLE names.

This method is no longer fully viable — while some Flock cameras still advertise via BLE, a large majority have turned off BLE advertisements and instead reveal themselves by sending out probe requests using WiFi.

This is presumably an update that some Flock cameras have gone through. The ones with this update only send out probe requests with a missing SSID (which is obfuscation) to connect to a hidden network that isn't broadcasting its SSID. This hidden network is likely an access point that a Flock employee would broadcast near the camera when trying to connect to it — further research will need to be done to confirm this.

Furthermore, the Republican candidate for Florida, James Fishback, is running on the promise of banning Flock cameras. If something like this were to happen in one state, as with dominoes, it could happen in others as well.

I found out that the first camera I showed in my original video no longer advertised BLE packets, which I found strange as it used to (visible in my first video on Flock cameras). I then made the assumption that perhaps they were advertising themselves via probe requests using WiFi. While looking into this, **@jakeswiz** was also doing research on it around the same time and figured it out and made a video — show him some love as I'm grateful for the work he has done as well.

As time progresses I will be doing more research into Flock cameras and trying to figure out more about how they work.

---

## Contributing

Contributions welcome! We need:
- MAC prefixes, OUIs, BLE UUIDs, SSID patterns
- Vendor fingerprints and wardriving captures
- Performance improvements and code enhancements

Submit PRs or open issues with your findings.

---

## Disclaimer
**This program was made for educational, ethical, and legal purposes only.** Use responsibly and in accordance with local laws.