Skip to content

McDaived/Bruce-Arabic

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bruce Main Menu

🦈 Bruce - Arabic Fork by Daived

⚠️ هذه نسخة غير رسمية (Unofficial Fork)

تم عمل هذه النسخة بواسطة Daived وهي عبارة عن شوكة (Fork) من المشروع الأصلي Bruce، تم فيها ترجمة كامل واجهة المستخدم إلى اللغة العربية مع دعم الخط العربي بشكل كامل على أجهزة ESP32.

هذه النسخة مفتوحة للتطوير والمساهمة عبر: https://github.com/McDaived


⚠️ This is an Unofficial Fork

This fork was created by Daived — a fully Arabic-translated version of the original Bruce firmware, with complete Arabic font and UI support for ESP32 devices.

Open for contributions and further development at: https://github.com/McDaived


Bruce is a versatile ESP32 firmware that supports a ton of offensive features focusing on facilitating Red Team operations. It also supports M5stack and Lilygo products and works great with Cardputer, Sticks, M5Cores, T-Decks and T-Embeds.

Check the original open-source hardware: https://bruce.computer/boards

🏗️ How to install

The easiest way to install Bruce is using the official Web 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>.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, just search for 'Bruce' on the device category you want to and click on burn

📑 Wiki

For more information on each function supported by Bruce, read the original wiki here. Also, read the FAQ

💻 List of Features

WiFi

BLE

  • BLE Scan
  • Bad BLE - Run Ducky scripts, similar to BadUsb
  • BLE Keyboard - Cardputer and T-Deck Only
  • iOS Spam
  • Windows Spam
  • Samsung Spam
  • Android Spam
  • Spam All

RF

  • Scan/Copy
  • Custom SubGhz
  • Spectrum
  • Jammer Full (sends a full squared wave into output)
  • Jammer Intermittent (sends PWM signal into output)
  • Config
  • Replay

RFID

  • Read tag
  • Read 125kHz
  • Clone tag
  • Write NDEF records
  • Amiibolink
  • Chameleon
  • Write data
  • Erase data
  • Save file
  • Load file
  • Config
  • Emulate tag

IR

FM

NRF24

Scripts

Others

Clock

  • RTC Support
  • NTP time adjust
  • Manual adjust

Connect (ESPNOW)

  • Send File
  • Receive File
  • Send Commands
  • Receive Commands

Config

  • Brightness
  • Dim Time
  • Orientation
  • UI Color
  • Boot Sound on/off
  • Clock
  • Sleep
  • 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 Guage LITE_VERSION
M5Stack Cardputer (and ADV) 🆗 🆗 🆗 🆗 🆗 🆗 🆗 NS4168
M5Stack M5StickC PLUS2 🆗 🆗 🆗 🆗 🆗 🆗¹ Tone
M5Stack M5StickC PLUS 🆗 🆗 🆗 🆗 🆗 🆗¹ Tone ❌²
M5Stack M5Core BASIC 🆗 🆗 🆗 🆗 🆗 🆗¹ Tone
M5Stack M5Core2 🆗 🆗 🆗 🆗 🆗 🆗¹
M5Stack M5CoreS3/SE 🆗 🆗 🆗 🆗 🆗
JCZN CYD‑2432S028 🆗 🆗 🆗 🆗 🆗¹ ❌²
Lilygo T‑Embed CC1101 🆗 🆗 🆗 🆗 🆗 🆗 🆗 🆗 🆗
Lilygo T‑Embed 🆗 🆗 🆗 🆗 🆗 🆗 🆗 🆗
Lilygo T-Display-S3 🆗 🆗 🆗
Lilygo T‑Deck (and pro) 🆗 🆗
Lilygo T-Watch-S3 🆗
Lilygo T-LoRa Pager 🆗
Smoochiee V2 🆗 🆗 🆗 🆗
ESP32-C5 🆗 🆗 🆗
Bruce RF Reaper 🆗 🆗 ❌ but w/ ST25R3916 🆗 🆗 🆗

² CYD have a LITE_VERSION version for Launcher Compatibility ¹ Core, CYD and StickCs Bad-USB: here

LITE_VERSION: TelNet, SSH, WireGuard, ScanHosts, RawSniffer, Brucegotchi, BLEBacon, BLEScan and Interpreter are NOT available for M5Launcher Compatibility

✨ Why and how does it look?

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.

Bruce Main Menu Bruce on M5Core Bruce on Stick Bruce on CYD

Other media can be found here.

👏 Acknowledgements

  • @Daived / McDaived for the Arabic translation and full RTL/Arabic font support fork.
  • @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.
  • @Tawank refactoring interpreter among many other things
  • @pablonymous new RF functions to read RAW Data
  • Smoochiee for Bruce PCB design.
  • TH3_KR4K3N for Stick cplus extender PCB design.
  • Everyone who contributed in some way to the project, thanks ❤️

🚧 Disclaimer

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.

About

This fork was created by Daived — a fully Arabic-translated version of the original Bruce firmware, with complete Arabic font and UI support for ESP32 devices.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors