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.
Read the documentation or try the Hound in your browser. The site uses Zensical, Hound's Midnight colors and original pixel art.
- Install from your browser
- Try the Hound, getting started and emulator guide
- Controls, hound care and appearance
- Speaker volume and test — saved Off / Low / Medium / High levels
- Optional vibration motor — settings, safe driver wiring and motor choices
- Alerts and ignores, Travel Watch and Follow Scent
- Detection coverage, storage and privacy
- Build firmware, run tests and contribute
- Release notes
- Development status, roadmap and release gates
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 serveOpen http://127.0.0.1:8000/. See documentation development for the strict build and GitHub workflow.
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.pyOpen 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.
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/ttyUSB0Install 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.
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.
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.
