Skip to content

About

ESP32 WiFi/BLE Sniffer Game, your pet hound sniffs out surveillance devices like Flock and many more.

Topics

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Repository files navigation

Surveillance Hound

An offline ESP32 radio-observation companion: six pixel dogs, passive Wi-Fi/Bluetooth clues and local logs. v0.1.0-alpha.2 prerelease. A match describes radio evidence, not intent or proof of surveillance.

Surveillance Hound firmware UI

Documentation

Read the documentation or try the Hound in your browser. The site uses Zensical, Hound's Midnight colors and original pixel art.

Preview the complete documentation and browser lab locally (Docker supplies the pinned WebAssembly compiler):

python3 -m venv .venv-docs
. .venv-docs/bin/activate
python -m pip install -r requirements-docs.txt
python tools/build_web.py --docker
python tools/build_flasher.py
npm ci --prefix tools/flasher --ignore-scripts
npm run build --prefix tools/flasher
zensical serve

Open http://127.0.0.1:8000/. See documentation development for the strict build and GitHub workflow.

Try the emulator

Requires Python 3.11+, CMake 3.22+, Ninja, a C++20 compiler and OpenSSL development headers.

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -r requirements-dev.txt
python3 tools/run_local.py

Open http://127.0.0.1:8765/. It runs the firmware UI with synthetic events and RAM-only progress. It does not capture USB radio data or write SD logs.

Hardware

Buy the tested Hosyond 4-inch ESP32 board (affiliate link).

The display target is the LCDWiki E32R40T / tested Hosyond 4-inch ESP32 board with ST7796 display and XPT2046 touch. Firmware uses ESP-IDF 6.0.2, pinned to 7101770dc6db2667b3c477cc31365dd1acd6db4e.

After activating the pinned SDK in a checkout without spaces:

idf.py build
./tools/flash.sh /dev/ttyUSB0

Install the current prerelease with the browser flasher (full installation resets saved board data), or build from source. Additional board support is coming soon.

See Building and getting started before flashing. An ESP32-C3 has a separate radio-only harness.

Status and scope

82 rules cover 21 categories. Hound listens for selected 2.4 GHz Wi-Fi management frames and legacy BLE advertisements; it does not associate, probe, advertise, inject or upload. Quiet scans are not an all-clear, and Travel Watch detects repeated nearby presence without proving movement.

Initial display/SD checks and host regressions are documented. Controlled RF accuracy, durability/power tests, formal soak and release/license acceptance remain open. The status page is the current summary; dated records preserve earlier evidence.

License

Copyright 2026 Jascha Wanger (https://dx.pe).

Firmware, tools and tests: Apache-2.0. Original docs/art: CC-BY-4.0. Independently assembled signature facts: CC0-1.0, with separate source terms. See LICENSE, NOTICE, dependency ledger and provenance.

About

ESP32 WiFi/BLE Sniffer Game, your pet hound sniffs out surveillance devices like Flock and many more.

Topics

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages