Bruce

Pentest View the repo

Bruce is an ESP32‑based firmware that delivers a comprehensive suite of offensive security tools—including Wi‑Fi, Bluetooth, RF, RFID, IR, FM, and scripting capabilities—for fast, portable Red Team operations, and it runs on many ESP32 devices such as M5Stack, Lilygo, and the custom RF REAPER board.

auto-summary

7344 stars · 2487 forksGitHub repo · as of 2026-11-21 11:07 UTC

Maintainer
brucedevices
License
AGPL-3.0
Distribution
releasesweb-flasheresp-web-toolsm5burner
Capabilities
wifiblesub-ghzrfid-nfcirbadusb
Chip families
esp32esp32-s3esp32-c5

Boards with a recipe, by trust tier

Known good

  • ESP32-C5-DevKitC-1Known goodEspressifrelease .bin
    Flash ESP32-C5-DevKitC-1in-browserknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Bruce publishes a dedicated `Bruce-esp32-c5.bin` in its official 1.16.1 release. The ESP32-C5-DevKitC-1 is the reference bare C5 devkit (no display), so the plain c5 build is its target; the `-tft` variant is for C5 boards with a screen. Verified on real hardware 2026-09-01: ESP32-C5-DevKitC-1, chip revision v1.2 (ROM esp32c5-eco3-20250704), ESP32-C5-WROOM-1 with 8 MB flash and no PSRAM. Bruce-esp32-c5.bin 1.16.1 (4,122,608 bytes, bootloader at 0x2000 inside the merged image) written at 0x0 with esptool 5.3.0 over the USB-to-UART port (CP2102N), hash verified, 211 s at 115200 (the C5 ROM does not support --baud changes). Boots cleanly: ROM -> second-stage -> app, no resets in a 10 s window; logs one 'MSPI Timing: Failed to allocate dummy cacheline for PSRAM memory barrier' error (module has no PSRAM - harmless) and one 'Invalid IO 255' pin warning. Headless board: Bruce runs on its serial CLI. CAVEAT: the in-browser flash of this same image through ESP Web Tools 10.4.0 fails on this silicon revision with 'Failed to initialize. Try resetting your device or holding the BOOT button while clicking INSTALL.' - esptool-js 0.6.1 does not know this chip's CHIP magic 0x30e1706f (espressif/esptool-js#262; chip-id detection merged upstream in #197, unreleased). Flash from a terminal until esptool-js ships a release and ESP Web Tools bumps.

  • T-DeckKnown goodLILYGOweb flasher
    Flash T-Deckweb flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'Lilygo T-Deck' in the project's device table.

  • T-Display-S3Known goodLILYGOweb flasher
    Flash T-Display-S3web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'Lilygo T-Display-S3' in the project's device table.

  • T-EmbedKnown goodLILYGOweb flasher
    Flash T-Embedweb flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'Lilygo T-Embed' in the project's device table; the T-Embed CC1101 variant is listed separately.

  • T-Watch S3Known goodLILYGOweb flasher
    Flash T-Watch S3web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'Lilygo T-Watch-S3' in the project's device table.

  • CardputerKnown goodM5Stackweb flasher
    Flash Cardputerweb flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'M5Stack Cardputer' in the project's device table. Also installable from M5Burner.

  • Core2Known goodM5Stackweb flasher
    Flash Core2web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'M5Stack M5Core2' in the project's device table. Also installable from M5Burner.

  • CoreS3Known goodM5Stackweb flasher
    Flash CoreS3web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'M5Stack M5CoreS3' (and SE) in the project's device table. Also installable from M5Burner.

  • StickC-Plus2Known goodM5Stackweb flasher
    Flash StickC-Plus2web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'M5Stack M5StickC PLUS2' in the project's device table. Also installable from M5Burner.

  • M5StickS3Known goodM5Stackweb flasher
    Flash M5StickS3web flasherknown-goodread the caveat

    Known good esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: Listed as 'M5Stack StickS3' in the device table on the project's own site.

Unverified

  • ES3C28P (2.8-inch ESP32-S3 Display)UnverifiedLCDWIKI
    Flash ES3C28P (2.8-inch ESP32-S3 Display)guidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: bruce names this board as ES3C28P in its platformio.ini (env ES3C28P); derived from the repo's own build files, not verified on hardware.

  • CoreUnverifiedM5Stack
    Flash Coreguidedread the caveat

    Unverified esp-atlas asserts this board↔firmware link at the shown trust tier — it does not guarantee your specific unit or the current firmware version. Flashing can erase keys/config and can brick the device. At your own risk.

    Caveat: bruce names this board as m5stack-core in its platformio.ini (env m5stack-core4mb); derived from the repo's own build files, not verified on hardware.