firmware

# :shark: Bruce Bruce is a versatile ESP32 firmware packed with offensive-security tools, built to make Red Team operations fast and portable. It also supports [M5Stack](https://shop.m5stack.com), [LILYGO](https://lilygo.cc) , [RockBase IoT](https://www.rockbaseiot.com) and [Elecrow](https://www.elecrow.com) products, and works great with the Cardputer, Sticks, M5Cores, T-Decks and T-Embeds. ## :zap: Get Our Official DevKit! # RF REAPER **RF REAPER** is our custom PCB devkit, purpose-built for Bruce! Every major feature works natively, right out of the box. Sub-GHz, NFC/RFID, IR, 2.4GHz(NRF), GPS-ready, and a microSD, all driven by a beefy ESP32-S3 (16MB Flash / 8MB PSRAM). Tons of GPIOs via the AW9523 expander plus Flipper Zero & iButton header compatibility mean you can hack, mod, and build on it endlessly. Want a specific function? Ask us with an issue, we'll check it. **[Buy the RF REAPER and official boards](https://shop.bruce.computer)** **Check our fully open-source hardware too:** https://bruce.computer/boards More custom devkit boards coming soon! Stay across our communities! ## :building_construction: How to install ### The easiest way to install Bruce is using our official Web Flasher! ### Check out: https://bruce.computer/flasher Alternatively, you can download the latest binary from releases or actions and flash locally using esptool.py ```sh esptool.py --port /dev/ttyACM0 write_flash 0x00000 Bruce-.bin ``` **For 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](https://docs.m5stack.com/en/download), 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 ## :keyboard: Discord Server Contact us in our [Discord Server](https://discord.gg/WJ9XF9czVT)! ## :bookmark_tabs: Wiki For more information on each function supported by Bruce, [read our wiki here](https://wiki.bruce.computer/). Also, [read our FAQ](https://wiki.bruce.computer/faq/) ## :computer: List of Features

WiFi

- [x] Connect to WiFi - [x] WiFi AP - [x] Disconnect WiFi - [x] [WiFi Atks](https://wiki.bruce.computer/features/wifi/#wifi-atks) - [x] [Beacon Spam](https://wiki.bruce.computer/features/wifi/#beacon-spam) - [x] [Target Atk](https://wiki.bruce.computer/features/wifi/#target-atks) - [x] Information - [x] Target Deauth - [x] EvilPortal + Deauth - [x] Deauth Flood (More than one target) - [x] [Wardriving](https://wiki.bruce.computer/features/gps/#wardriving) - [x] [TelNet](https://wiki.bruce.computer/features/wifi/#telnet) - [x] [SSH](https://wiki.bruce.computer/features/wifi/#ssh) - [x] [RAW Sniffer](https://wiki.bruce.computer/features/wifi/#raw-sniffer) - [x] [TCP Client](https://wiki.bruce.computer/features/wifi/#client-tcp) - [x] [TCP Listener](https://wiki.bruce.computer/features/wifi/#listen-tcp) - [x] [Evil Portal](https://wiki.bruce.computer/features/wifi/#evil-portal) - [x] [Scan Hosts](https://wiki.bruce.computer/features/wifi/#scan-hosts) (with TCP Port scanning) - [x] [Responder](https://wiki.bruce.computer/features/wifi/#responder) - [x] [Arp Spoofing](https://wiki.bruce.computer/features/wifi/#arp-spoofing) - [x] [Arp Poisoning](https://wiki.bruce.computer/features/wifi/#arp-poisoning) - [x] [Wireguard Tunneling](https://wiki.bruce.computer/features/wifi/#wireguard-tunneling) - [x] Brucegotchi - [x] Pwnagotchi friend - [x] Pwngrid spam faces & names - [x] [Optional] DoScreen a very long name and face - [x] [Optional] Flood uniq peer identifiers

BLE

- [x] [BLE Scan](https://wiki.bruce.computer/features/ble/#ble-scan) - [x] Bad BLE - Run Ducky scripts, similar to [BadUsb](https://wiki.bruce.computer/features/ble/#badble) - [x] BLE Keyboard - Cardputer and T-Deck Only - [x] iOS Spam - [x] Windows Spam - [x] Samsung Spam - [x] Android Spam - [x] Spam All

RF

- [x] Scan/Copy - [x] [Custom SubGhz](https://wiki.bruce.computer/features/rf/#replay-payloads-like-flipper) - [x] Spectrum - [x] Jammer Full (sends a full squared wave into output) - [x] Jammer Intermittent (sends PWM signal into output) - [x] Config - [x] RF TX Pin - [x] RF RX Pin - [x] RF Module - [x] RF433 T/R M5Stack - [x] [CC1101 (Sub-Ghz)](https://wiki.bruce.computer/features/rf/#cc1101) - [x] RF Frequency - [x] Replay

RFID

- [x] Read tag - [x] Read 125kHz - [x] Clone tag - [x] Write NDEF records - [x] Amiibolink - [x] Chameleon - [x] Write data - [x] Erase data - [x] Save file - [x] Load file - [x] Config - [x] [RFID Module](https://wiki.bruce.computer/features/rfid/#supported-modules) - [x] PN532 - [x] PN532Killer - [ ] Emulate tag

IR

- [x] TV-B-Gone - [x] IR Receiver - [x] [Custom IR (NEC, NECext, SIRC, SIRC15, SIRC20, Samsung32, RC5, RC5X, RC6)](https://wiki.bruce.computer/features/ir/#replay-payloads-like-flipper) - [x] Config - [X] Ir TX Pin - [X] Ir RX Pin

FM

- [x] [Broadcast standard](https://wiki.bruce.computer/features/fm/#broadcast-standard) - [x] [Broadcast reserved](https://wiki.bruce.computer/features/fm/#broadcast-standard) - [x] [Broadcast stop](https://wiki.bruce.computer/features/fm/#broadcast-stop) - [ ] [FM Spectrum](https://wiki.bruce.computer/features/fm/#fm-spectrum) - [ ] [Hijack Traffic Announcements](https://wiki.bruce.computer/features/fm/#hijack-ta) - [ ] [Config](https://wiki.bruce.computer/features/fm/#bookmark_tabs-config)

NRF24

- [x] [NRF24 Jammer](https://wiki.bruce.computer/features/nrf24/) - [x] 2.4G Spectrum - [ ] Mousejack

Scripts

- [x] [JavaScript Interpreter](https://wiki.bruce.computer/features/js-interpreter/) [Credits to justinknight93](https://github.com/justinknight93/Doolittle)

Others

- [x] Mic Spectrum - [x] [QRCodes](https://wiki.bruce.computer/features/others/#qrcodes) - [x] Custom - [x] PIX (Brazil bank transfer system) - [x] [SD Card Mngr](https://github.com/pr3y/Bruce/wiki/Others#sd-card-mngr) - [x] View image (jpg) - [x] File Info - [x] [Wigle Upload](https://wiki.bruce.computer/features/gps/#how-to-use-wigle) - [x] Play Audio - [x] View File - [x] LittleFS Mngr - [x] [WebUI](https://wiki.bruce.computer/controlling-device/webui/) - [x] Server Structure - [x] Html - [x] SDCard Mngr - [x] Spiffs Mngr - [x] Megalodon - [x] [BADUsb (New features, LittleFS and SDCard)](https://wiki.bruce.computer/features/others/#badusb) - [x] USB Keyboard - Cardputer and T-Deck Only - [x] [iButton](https://wiki.bruce.computer/features/others/#ibutton) - [x] LED Control

Clock

- [x] RTC Support - [x] NTP time adjust - [x] Manual adjust

Connect (ESPNOW)

- [x] Send File - [x] Receive File - [x] Send Commands - [x] Receive Commands

Config

- [x] Brightness - [x] Dim Time - [x] Orientation - [x] UI Color - [x] Boot Sound on/off - [x] Clock - [x] Sleep - [x] Restart ## Specific functions per Device, the ones not mentioned here are available to all. | Device | CC1101 | NRF24 | FM Radio | PN532 | Mic | BadUSB | RGB Led | Speaker | Fuel Gauge | LITE_VERSION | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----: | :---: | :------: | :------------------: | :--: | :----: | :-----: | :-----: | :--------: | :----------: | | [M5Stack Cardputer](https://shop.m5stack.com/products/m5stack-cardputer-kit-w-m5stamps) (and ADV) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | NS4168 | :x: | :x: | | [M5Stack M5StickC PLUS2](https://shop.m5stack.com/products/m5stickc-plus2-esp32-mini-iot-development-kit) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | Tone | :x: | :x: | | [M5Stack M5StickC PLUS](https://shop.m5stack.com/products/m5stickc-plus-esp32-pico-mini-iot-development-kit) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | Tone | :x: | :x:² | | [M5Stack M5Core BASIC](https://shop.m5stack.com/products/basic-core-iot-development-kit) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | Tone | :x: | :x: | | [M5Stack M5Core2](https://shop.m5stack.com/products/m5stack-core2-esp32-iot-development-kit-v1-1) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok:¹ | :x: | :x: | :x: | :x: | | [M5Stack M5CoreS3](https://shop.m5stack.com/products/m5stack-cores3-esp32s3-lotdevelopment-kit)/[SE](https://shop.m5stack.com/products/m5stack-cores3-se-iot-controller-w-o-battery-bottom) | :ok: | :ok: | :ok: | :ok: | :x: | :ok: | :x: | :x: | :x: | :x: | | [JCZN CYD‑2432S028](https://www.aliexpress.us/item/3256804774970998.html) | :ok: | :ok: | :ok: | :ok: | :x: | :ok:¹ | :x: | :x: | :x: | :x:² | | [Lilygo T‑Embed CC1101](https://lilygo.cc/products/t-embed-cc1101) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :x: | | [Lilygo T‑Embed](https://lilygo.cc/products/t-embed) | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :ok: | :x: | :x: | | [Lilygo T-Display-S3](https://lilygo.cc/products/t-display-s3) | :ok: | :ok: | :x: | :x: | :x: | :ok: | :x: | :x: | :x: | :x: | | [Lilygo T‑Deck](https://lilygo.cc/products/t-deck) ([and pro](https://lilygo.cc/products/t-deck-plus-1)) | :ok: | :x: | :x: | :x: | :x: | :ok: | :x: | :x: | :x: | :x: | | [Lilygo T-Watch-S3](https://lilygo.cc/products/t-watch-s3) | :x: | :x: | :x: | :x: | :x: | :ok: | :x: | :x: | :x: | :x: | | [Lilygo T-LoRa Pager](https://lilygo.cc/products/t-lora-pager)