Brucia

The phone is the brain  ·  the ESP32 is the antenna

ESP32 firmware and an Android app for radio and security research.

Use desktop Chrome or Edge - this browser has no Web Serial. Serial access was not allowed. Download the app Buy the board

Flash from desktop Chrome or Edge with a data USB cable. On Android, use the app’s USB flasher. Install activates when a matching release image is available; it is first checked against the size and SHA-256 the release lists (older releases without a digest are shown as unverified).

USB companion ESP32-S3 Wi-Fi · BLE · Sub-GHz · NFC · IR · NRF24 · Audio AGPL-3.0 No ads · No telemetry
The public workspace

Capture on the board. Inspect on the phone.

Brucia is a fork of Bruce. The ESP32 handles radio timing and capture; the Android app handles storage, analysis and the interface. The device also works on its own.

Start with the connection guide. The previews below use fixture data; they are not phone captures or evidence of a physical radio effect.

Compose preview renders: dashboard, report and IR catalog with fixture data
See the app in action

Open it. Try it. See the result.

Screen recordings of the released Android app, version 0.1.12, running in an emulator. Real navigation, downloads and results. The WPA demo uses synthetic data; no radio or NFC device is connected.

Why Brucia

Brucia vs Flipper vs Bruce

This comparison describes implemented features. Hardware support varies by board; many paths still need end-to-end testing. See the test checklist before relying on a feature.

CapabilityFlipper ZeroBruceBrucia
LilyGo T-Embed CC1101
Wi-FiExternal Wi-Fi boardNative ESP32 Wi-FiNative; phone-side maps, capture analysis and workflow
BLEBuilt in; mobile app and community appsBuilt in; board-dependent toolsDevice radio plus Android analysis and controls
Sub-GHzCC1101 with supported protocol libraryCC1101 on this boardSame radio; protocol coverage and RF performance require individual verification
NFC 13.56 MHzST25R3916; card-specific reading/emulationPN532 on this boardPN532: compatible reads/writes, Type 4 NDEF and identity-only FeliCa target paths; no universal emulation
RFID 125 kHzNative read/emulate/write for supported tagsNo stock LF hardwareUnavailable on stock T-Embed; compatible add-on integration required
iButtonBuilt-in contacts and supported protocolsNo stock contactsUnavailable on stock T-Embed; hardware/interface support required
InfraredBuilt-in TX/RXBuilt-in TX/RX on this boardDevice TX/RX with phone catalog and custom layouts
AudioNo built-in microphoneBoard microphone/speaker and audio toolsExisting DSP, SSTV RX/TX, DTMF, scope and RTTTL composer; physical signal chain pending
NRF24 / LoRa / FM / EthernetExternal hardware where supportedExternal modules where supportedOptional modules; presence and operation support gate each tool
Mobile workflowOfficial mobile app existsPrimarily device UI / WebUI / CLINative Android companion; phone compute, storage, GPS and display
Firmware updatesOfficial update tools and mobile workflowBoard-specific distributionRelease parsing/download/flash code; final installation and recovery acceptance pending
PowerStandalone batteryStandalone board batteryUSB power depends on phone/OTG/cable; also consumes the phone battery
Infinite battery · SERIAL-KILLERFiniteFinitePowered by your phone. The phone has opinions.

Stock hardware compared; optional add-ons are listed separately. Support varies by board and operation. Read the comparison, limits and primary sources.

Getting started

Flash in three steps

Use desktop Chrome or Edge with a USB data cable. Install choices come from the published release.

Downloads are resolved from the public release. Check the selected board, version and verification status; unavailable assets keep installation disabled. Historical bundled files are not a fallback. A published build does not certify every physical function.

1 · Flash the firmware

  1. Pick your board below, then plug it in with a data cable.
  2. Click Install Brucia and pick the serial port.
  3. Wait for the write to finish and the device to reboot into Brucia.

Checking published firmware assets...

Chip family: ESP32-S3

Use desktop Chrome or Edge - this browser has no Web Serial. Serial access was not allowed.

The LilyGo T-Embed CC1101 is the reference board; final hardware acceptance of current builds is pending. Other configured boards are experimental - treat it as experimental; it may not boot or some features may not work. For a normal failed firmware write, if the board will not start, hold BOOT and press RESET to re-enter download mode, then flash again.

Cannot enter download mode?
  • LilyGo T-Embed / CC1101 - hold the encoder (center) button and press RST, release RST, then release the encoder.
  • M5 Cardputer - power off, hold G0 (the top-right key), then connect USB.
  • M5 StickC / Plus - jumper GND to G0 while powering on.
  • Generic ESP32 - hold BOOT, plug in (or press RST), then release BOOT.

Source build: python3 tools/build_firmware.py -e lilygo-t-embed-cc1101. See the repository guide for uploading.

2 · Connect the app

Do this after step 1 has flashed Brucia and the device has rebooted into it. From then on you can update the firmware itself from inside the app - no need to re-flash from the browser.

  1. Install the app from Releases.
  2. Plug the device into the phone; tap Brucia on the device home.
  3. Open the app and tap Connect over USB.

For authorized security research and education only.

The split design

What you can work with

The device captures and transmits; the phone brings compute, storage, GPS and a full GUI. Everything below is for authorized security research and education only.

Brucia's distinctive workspaces combine Android audio/DSP and SSTV, persistent Wi-Fi/BLE history and place comparisons, phone-side WPA dictionary verification, and an HTTP/HTTPS inspection proxy. De Bruijn, spam, replay and remote control are included tools, not claims of exclusive invention. Read the source-backed comparison.

01

Wi-Fi and dictionary attacks

Wardrive with phone GPS and exports; WPA/WPA2 handshake and PMKID dictionary verification on Android, with wordlists and candidate rules. Device tools include deauth, sniffers, beacon spam, monitor capture and ARP MITM.

02

MITM HTTPS proxy

Inspect HTTP and HTTPS on configured lab clients with a local CA. Clients must trust that CA; certificate pinning can prevent inspection.

03

Sub-GHz

Capture to CSV, a rolling-code-aware decoder, .sub import and export, De Bruijn brute force, a spectrum waterfall, replay, jammer and radio config.

04

NFC / RFID

PN532 tools for compatible tags: reads, NDEF writes, dump comparison and selected emulation paths. Support depends on the card type and operation.

05

Infrared and Spam IR

Remote catalog, signal learning, TV-B-Gone, raw replay and IR power spam, with one shared run across the IR screen and Spam hub. Receiver response requires a physical check.

06

Bluetooth LE

Scanner, an advertisement spam hub (Apple, Android, Windows, Samsung), a GATT explorer and BadBLE.

07

NRF24 add-on

With the 2.4 GHz module attached: channel scanner, Enhanced ShockBurst sniffer, jammer and MouseJack.

08

Tools & offload

On-device JavaScript, iButton, clock, speaker and mic, mic spectrum and ESP-NOW, plus phone-side session reports with OSINT and insights, a live console, a file manager and a remote screen mirror.

09

In-app updates

Update the app over the air and flash new device firmware over USB, straight from inside the app.

10

Audio from the mic

Driven by the ESP microphone and speaker: live spectrum, a waterfall spectrogram, an SSTV decoder and transmitter (Robot36 and more), a tone and DTMF detector/generator, and an oscilloscope.

11

Adaptive UI

The device reports module capabilities; unavailable tools are disabled. Driver initialization and a physical end-to-end test are recorded separately in the verification checklist.

12

Private and local

Everything runs on your phone and the device. No accounts, no analytics, no telemetry; nothing is collected or stored on our servers and your captures stay on your phone. Network access is used for updates, optional datasets, map tiles and services you choose, including WiGLE and network research tools.

Learn

Documentation

Your first connection, your next experiment, or your first contribution. Start here.

Built something useful? Found a rough edge? Help improve a guide, share a device check or contribute a fix. Read how to get involved.

Support

Support development

No ads, no paid tiers, no telemetry. Support is purely optional.

Captures are stored on your phone. Updates, map tiles, optional datasets and services such as WiGLE use the network. Uploads and exports are actions you choose.

Buying the board through the affiliate link also supports the project.

Bitcoin donation QR

Bitcoin

bc1qee8a06x886ng8ce6qy84l6u6x54jnjsesgqym7
Monero donation QR

Monero

46qDyafRkn1at3E2GMwuESBeqzpt74xE8S2kjPe35EUyKiS57Ho7cLB1vD2zH4hPmjYcYzWWxSSLZAYB5Hp1yDFrKnPWkR7