How ideagrey/millie works
MILLIE combines an Android field unit for passive WiFi/BLE surveillance with an optional ESP32 CYD sniffer and a Raspberry Pi component that can scan locally, ingest sensor data, sync with the phone, and expose a hub dashboard. The main workflow is signal capture, transfer to the phone, and live device/radar presentation; the Pi also archives phone snapshots and sensor events. The README documents phone capabilities not represented in sampled Android source, so those branches are shown at the app level. Evidence for unsampled implementations and wiring is limited to the README and SOURCE INDEX.
Main entry points: __main__.py Pi runtime entry · hub_server.py Hub API · phone_client.py Phone API client · sync_worker.py Phone and ESP sync
Components 19
Android field unit
- MILLIE phone app
MILLIE CYD.ino - Phone detection
MILLIE CYD.ino - Device classification
MILLIE CYD.ino - Radar and details
MILLIE CYD.ino - Export and protection
MILLIE CYD.ino
Pi sensing
- Pi runtime entry
millie-pi/millie_pi/__main__.py - Configuration
millie-pi/millie_pi/config.py - Active RF node
millie-pi/millie_pi/active_node.py - WiFi and BLE scanner
millie-pi/millie_pi/rf_scanner.py - RF scan script
millie-pi/millie_pi/rf-scan.sh
Pi hub
- Phone API client
millie-pi/millie_pi/phone_client.py - Phone and ESP sync
millie-pi/millie_pi/sync_worker.py - CYD serial reader
millie-pi/millie_pi/esp_reader.py - Hub archive
millie-pi/millie_pi/storage.py - Hub API
millie-pi/millie_pi/hub_server.py - Hub dashboard
millie-pi/static/hub.html
External sensors
- ESP32 CYD
MILLIE CYD.ino
Other components
- Field user
- Dashboard user
Connections 22
- Field user → MILLIE phone app: uses
README - MILLIE phone app → Phone detection: captures signals
README - Phone detection → Device classification: classifies devices
README - Device classification → Radar and details: displays findings
README - MILLIE phone app → Export and protection: offers
README - Pi runtime entry → Configuration: loads
millie-pi/millie_pi/__main__.py - Pi runtime entry → Active RF node: starts
millie-pi/millie_pi/__main__.py - Pi runtime entry → Phone API client: creates
millie-pi/millie_pi/__main__.py - Pi runtime entry → WiFi and BLE scanner: runs diagnostics
millie-pi/millie_pi/__main__.py - Active RF node → WiFi and BLE scanner: scans and drains
millie-pi/millie_pi/active_node.py - Active RF node → Phone API client: pushes events
millie-pi/millie_pi/active_node.py - WiFi and BLE scanner → RF scan script: invokes
millie-pi/millie_pi/rf_scanner.py - Phone and ESP sync → Phone API client: fetches phone data
millie-pi/millie_pi/sync_worker.py - Phone and ESP sync → Hub archive: archives sync data
millie-pi/millie_pi/sync_worker.py - Phone and ESP sync → CYD serial reader: starts optional ingest
millie-pi/millie_pi/sync_worker.py - CYD serial reader → Hub archive: delivers sensor events
millie-pi/millie_pi/sync_worker.py - Hub API → Hub archive: reads hub data
millie-pi/millie_pi/hub_server.py - Hub API → Phone API client: proxies commands
millie-pi/millie_pi/hub_server.py - Hub API → Hub dashboard: serves
millie-pi/millie_pi/hub_server.py - Dashboard user → Hub API: requests dashboard
- ESP32 CYD → Phone detection: captures hidden probes
README - Dashboard user → Hub dashboard: views