Installation

Installation

From a release

Download flipdeflock.fap from the latest release, copy it to apps/Tools/ on your Flipper's SD card, and launch FlipDeFlock from the Tools menu.

Every push to main also builds a fresh .fap as a CI artifact under the repo's Actions tab, if you want an unreleased build.

If a newer firmware bumps the API and the app refuses to load ("API mismatch"), that's a version skew, not a bug — rebuild it yourself; see below.

Build from source

With ufbt (standalone, no Flipper SDK checkout needed):

pip install ufbt
ufbt            # builds flipdeflock.fap in dist/
ufbt launch     # build + install + run on a connected Flipper

Inside a Momentum or stock-OFW firmware tree: drop this folder into applications_user/ and run:

./fbt fap_flipdeflock

Both build paths target Flipper API 87.1.

Hardware you need first

• A Flipper Zero.
• An ESP32 board — the Flipper's own radio is BLE-only and can't do Wi-Fi monitor mode, so Wi-Fi detection runs on the ESP32. See Hardware Compatibility for supported boards and wiring.
• Optional: a GPS module, for geotagging, Flock Map, and Locator.

Set Board Mode in Settings to match your ESP32's firmware (Marauder or Companion) — see Features & Board Modes.

ESP32 companion firmware

For the full feature set (WiFi Audit, BLE/Tracker Scan, Net Guardian, Locator, dual-band Flock detection), flash the project's own ESP32 firmware. Do this from the Flipper itself with ESP32 Firmware → Flash a .bin — no computer needed — or with Arduino IDE / arduino-cli; see esp32_companion/README.md in the repo.

Problems

Common install and build issues (API mismatch, UART busy, no detections, GPS no-fix, flasher error codes) are covered in Troubleshooting.