Bruce is meant to be a versatile ESP32 firmware that supports a ton of offensive features focusing on facilitating Red Team operations. It also supports m5stack products and works great with Cardputer, Sticks and M5Cores.
Check out: https://bruce.computer/flasher
Alternatively, you can download the latest binary from releases or actions and flash locally using esptool.py
esptool.py --port /dev/ttyACM0 write_flash 0x00000 Bruce-<device>.binFor m5stack devices
If you already use M5Launcher to manage your m5stack device, you can install it with OTA
Or you can burn it directly from the m5burner tool, just search for 'Bruce' (My official builds will be uploaded by "owner" and have photos.) on the device category you want to and click on burn
Contact us in our Discord Server!
For more information on each function supported by Bruce, read our wiki here. Also, read our FAQ
- Connect to WiFi
- WiFi AP
- Disconnect WiFi
- WiFi Atks
- Beacon Spam
- Target Atk
- Information
- Target Deauth
- EvilPortal Deauth
- Deauth Flood (More than one target)
- Wardriving
- TelNet
- SSH
- RAW Sniffer
- DPWO-ESP32
- Evil Portal
- Scan Hosts
- Wireguard Tunneling
- Brucegotchi
- Pwnagotchi friend
- Pwngrid spam faces & names
- [Optional] DoScreen a very long name and face
- [Optional] Flood uniq peer identifiers
- Scan/Copy
- Custom SubGhz
- Spectrum
- Jammer Full (sends a full squared wave into output)
- Jammer Intermittent (sends PWM signal into output)
- Config
- RF TX Pin
- RF RX Pin
- RF Module
- RF433 T/R M5Stack
- CC1101 (Sub-Ghz)
- RF Frequency
- Replay
- Read tag
- Read 125kHz
- Clone tag
- Write NDEF records
- Amiibolink
- Chameleon
- Write data
- Erase data
- Save file
- Load file
- Config
- RFID Module
- PN532
- RFID Module
- Emulate tag
- TV-B-Gone
- IR Receiver
- Custom IR (NEC, NEC42, NECExt, SIRC, SIRC15, SIRC20, Samsung32, RC5, RC5X, RC6)
- Config
- Ir TX Pin
- Ir RX Pin
- NRF24 Jammer
- 2.4G Spectrum
- Mousejack
- Mic Spectrum
- QRCodes
- Custom
- PIX (Brazil bank transfer system)
- SD Card Mngr
- View image (jpg)
- File Info
- Wigle Upload
- Play Audio
- View File
- LittleFS Mngr
- WebUI
- Server Structure
- Html
- SDCard Mngr
- Spiffs Mngr
- Megalodon
- BADUsb (New features, LittleFS and SDCard)
- USB Keyboard - Cardputer and T-Deck Only
- Openhaystack
- LED Control
| Device | CC1101 | NRF24 | Interpreter | FMRadio | PN532 | Mic_SPM1423 | BadUSB | RGB Led | Speaker | LITE_MODE |
|---|---|---|---|---|---|---|---|---|---|---|
| Cardputer | 🆗 | 🆗 | 🆗 | 🆗 | 🆗 | 🆗 | 🆗 | 🆗 | NS4168 | ❌ |
| StickCPlus2 | 🆗 | 🆗 | 🆗 | 🆗 | 🆗 | 🆗 | 🆗¹ | ❌ | Tone | ❌ |
| StickCPlus 1.1 | 🆗 | 🆗 | ❌ | 🆗 | 🆗 | 🆗 | 🆗¹ | ❌ | Tone | ❌² |
| Core | ❌ | ❌ | ❌ | ❌ | ❌ | 🆗 | 🆗¹ | ❌ | Tone | ❌ |
| Core2 | ❌ | ❌ | ❌ | ❌ | ❌ | 🆗 | 🆗¹ | ❌ | ❌ | ❌ |
| CoreSe/SE | ❌ | ❌ | 🆗 | ❌ | ❌ | ❌ | 🆗 | ❌ | ❌ | ❌ |
| CYD-2432S028 | 🆗 | 🆗 | 🆗 | ❌ | 🆗 | ❌ | 🆗¹ | ❌ | ❌ | ❌² |
| Lilygo T-Embed CC1101 | 🆗 | ❌ | 🆗 | ❌ | 🆗 | 🆗 | 🆗 | ❌ | ❌ | ❌ |
| Lilygo T-Embed | ❌ | ❌ | 🆗 | ❌ | 🆗 | 🆗 | 🆗 | ❌ | ❌ | ❌ |
| Lilygo T-Deck (and pro) | ❌ | ❌ | 🆗 | ❌ | ❌ | ❌ | 🆗 | ❌ | ❌ | ❌ |
² CYD and StickCPlus 1.1 have a LITE_VERSION version for Launcher Compatibility ¹ Core, CYD and StickCs Bad-USB: here
LITE_MODE: TelNet, SSH, DPWO, WireGuard, ScanHosts, RawSniffer, Brucegotchi, BLEBacon, BLEScan, Interpreter and OpenHaystack are NOT available for M5Launcher Compatibility
Bruce stems from a keen observation within the community focused on devices like Flipper Zero. While these devices offered a glimpse into the world of offensive security, there was a palpable sense that something more could be achieved without being that overpriced, particularly with the robust and modular hardware ecosystem provided by ESP32 Devices, Lilygo and M5Stack products.
Other media can be found here.
- @bmorcelli for new core and a bunch of new features, also porting to many devices!
- @IncursioHack for adding RF and RFID modules features.
- @Luidiblu for logo and UI design assistance.
- @eadmaster for adding a lot of features.
- @rennancockles for a lot of RFID code, refactoring and others features.
- @7h30th3r0n3 refactoring and a lot of help with WiFi attacks.
- Smoochiee for Bruce PCB design.
- TH3_KR4K3N for Stick cplus extender PCB design.
- Everyone who contributed in some way to the project, thanks ❤️
Bruce is a tool for cyber offensive and red team operations, distributed under the terms of the Affero General Public License (AGPL). It is intended for legal and authorized security testing purposes only. Use of this software for any malicious or unauthorized activities is strictly prohibited. By downloading, installing, or using Bruce, you agree to comply with all applicable laws and regulations. This software is provided free of charge, and we do not accept payments for copies or modifications. The developers of Bruce assume no liability for any misuse of the software. Use at your own risk.
