Docs Github Install Discord Donate

πŸš€ New Open-Source PCB Released!

We’re excited to announce the release of our new open-source PCB (CERN-OHL-P-2.0 License) that is fully compatible with the Bruce Firmware! Designed for flexibility and ease of use, this PCB brings new possibilities for integration with our firmware.

You can find the full documentation and schematics on our GitHub. If you’re a developer or hobbyist, feel free to check out the design files and start building your own device today!

View PCB on GitHub

You can buy Bruce's PCB directly with our sponsor pcbway, just select PCB Assembly and it should be good to go

Click on the button below to buy!

PCB from PCBWay

What is Bruce Firmware?

Bruce is meant to be a versatile ESP32 firmware that supports a ton of offensive features focusing to facilitate on Red Team operations.

It also supports M5stack and LILYGO products and works great with Cardputer, Sticks cplus, T-Decks and T-embeds.

What is Bruce for?

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 and LILYGO or M5Stack products.

πŸ“œ Is it open-source?

YES! You can check our github repo to see all our code, which is available under the AGPL license.

Free as in freedom

Contributions are welcome <3

πŸ› οΈ How can i Install it?

The easiest way to install Bruce is using the WebFlasher! which is the 'Install' button above!

But if you already use M5Launcher to manage your m5stack device, you can install it with OTA

You can also 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.

πŸ”Œ Supported Modules

Specific functions per Device, the ones not mentioned here are available to all.

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) ❌ ❌ βœ… ❌ ❌ ❌ βœ… ❌ ❌ ❌

LITE_MODE: TelNet, SSH, DPWO, WireGuard, BLEScan and OpenHaystack are NOT available for M5Launcher Compatibility

πŸ–₯️ List of Features

Click on the categories below

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 βœ…
NRF24 Jammer βœ…
TelNet βœ…
SSH βœ…
RAW Sniffer βœ…
DPWO-ESP32 βœ…
Evil Portal βœ…
Scan Hosts βœ…
Wireguard Tunneling βœ…
Pwnagotchi βœ…
Pwnagotchi friend βœ… 
Pwngrid spam faces & names βœ…
Optional: DoScreen a very long name and face βœ… 
Optional: Flood uniq peer identifiers βœ… 
Mousejack ☐ 
BLE Scan βœ…
Bad BLE - Run Ducky scripts, similar to BadUsb βœ… 
BLE Keyboard - Cardputer Only (for now) βœ…
NRF24 Jammer βœ…
iOS Spam βœ…
Windows Spam βœ…
Samsung Spam βœ…
Android Spam βœ…
Spam All βœ…
      
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 βœ…
Write data βœ…
Erase data βœ…
Save file βœ…
Load file βœ…
Config βœ…
RFID Module βœ…
PN532 βœ…
Emulate tag ☐
      
TV-B-Gone βœ…
IR Receiver βœ…
Custom IR βœ…
- Config βœ…
- Ir TX Pin βœ…
- Ir RX Pin βœ…
      
Broadcast standard βœ…
Broadcast reserved βœ…
Broadcast stop βœ…
FM Spectrum ☐
Hijack Traffic Announcements ☐
Config ☐
      
NRF24 Jammer βœ…
2.4G Spectrum βœ…
      
Mic Spectrum βœ…
QRCodes βœ…
- Custom βœ…
- PIX (Brazil bank transfer system) βœ…
SD Card Mngr βœ…
- View image (jpg) βœ…
- File Info βœ…
- Wigle Upload βœ…
- Play Audio βœ…
- View File βœ…
SPIFFS Mngr βœ…
WebUI βœ…
- Server Structure βœ…
- Html βœ…
- SDCard Mngr βœ…
- LittleFS Mngr βœ…
Megalodon βœ…
BADUsb (New features, SPIFFS and SDCard) βœ…
USB Keyboard βœ…
Openhaystack βœ…
LED Control βœ…
JavaScript Interpreter βœ…
      
RTC Support βœ…
NTP Time adjust βœ…
Manual Time adjust βœ…
      
Send File βœ…
Receive File βœ…
      
Brightness βœ…
Dim Time βœ…
Orientation βœ…
UI Color βœ…
Clock βœ…
Sleep βœ…
Restart βœ…
      

⚑ Some Schematics

CC1101 on M5Stack Stick Cplus

CC1101 on M5Stack Cardputer

CC1101 on M5Stack Cardputer with SD Sniffer

Read the wiki for more.

Those CC1101 connections are the same for NRF24!