How bigbrodude6119/flipper-zero-friend-finder works
Friend Finder is a Flipper Zero app paired with ESP32 WiFi firmware. The main workflow is: the user starts listening, the board scans nearby WiFi traffic and reports peers over UART, the app parses and tracks them, and the user can inspect the friend history or send a selected payload back through the board. The README also documents harmless built-in/custom payloads and communication with other Friend Finder devices. Source excerpts establish the app’s scene dispatch and parts of the sending flow; some firmware and scene links rely on the SOURCE INDEX or README, so unsampled internals are not expanded.
Main entry points: uart.c UART link · persistence.c Persistence · protocol.c Line protocol · scene_send_menu.c Payload menu
Components 21
Flipper app
- App and scenes
main.c - Main screen
src/scene_main_menu.c - Listen screen
src/scene_listen.c - Monitor screen
src/scene_monitor.c - Friend details
src/scene_device_detail.c - Settings
src/scene_settings.c
Peer discovery
- UART link
src/uart.c - Line protocol
src/protocol.c - JSON validation
src/safe_json.c - Peer tracking
src/pwnagotchi.c
Payload sending
- Payload menu
src/scene_send_menu.c - Send options
src/scene_send_options.c - Sending session
src/scene_sending.c - Payload catalog
src/payload_loader.c - Built-in payloads
src/payloads.c
ESP32 firmware
- WiFi scanning
esp32_firmware/main/wifi_sniffer.c - Board UART protocol
esp32_firmware/main/uart_proto.c - Beacon injection
esp32_firmware/main/beacon_inject.c
Local state
- Persistence
src/persistence.c
Other components
- Flipper user
- Nearby peers
Connections 31
- Flipper user → App and scenes: starts app
README.md - App and scenes → Main screen: dispatches scenes
main.c - Flipper user → Listen screen: starts listening
- Listen screen → UART link: requests scanning
- Main screen → UART link: reads link state
src/scene_main_menu.c - Nearby peers → WiFi scanning: emit WiFi traffic
README.md - WiFi scanning → Board UART protocol: reports detections
esp32_firmware/main/wifi_sniffer.c - Board UART protocol → UART link: sends UART lines
esp32_firmware/main/uart_proto.c - UART link → Line protocol: processes received lines
src/uart.c - Line protocol → JSON validation: validates peer JSON
src/protocol.c - Line protocol → Peer tracking: updates peer records
src/protocol.c - Peer tracking → Persistence: updates friend history
src/pwnagotchi.c - Flipper user → Friend details: inspects peers
- Flipper user → Monitor screen: monitors scanning
- Flipper user → Settings: configures app
- Settings → Persistence: saves settings
src/scene_settings.c - Flipper user → Payload menu: chooses payload
- Payload menu → Payload catalog: loads choices
src/scene_send_menu.c - Payload catalog → Built-in payloads: loads built-ins
src/payload_loader.c - Payload menu → Persistence: loads profiles
src/scene_send_menu.c - Flipper user → Send options: sets send options
- Send options → Persistence: saves options
src/scene_send_options.c - Payload menu → Sending session: opens session
- Sending session → Payload catalog: builds payload JSON
src/scene_sending.c - Sending session → Persistence: saves active profile
src/scene_sending.c - Sending session → Line protocol: sends payload command
src/scene_sending.c - Line protocol → UART link: transmits command
src/protocol.c - UART link → Board UART protocol: sends UART command
- Board UART protocol → Beacon injection: dispatches injection
esp32_firmware/main/uart_proto.c - Beacon injection → Nearby peers: broadcasts payload
README.md - Persistence → App and scenes: loads saved data
main.c