brucedevices/firmwareशिकारी ESP32 फ़र्मवेयर
# :shark: Bruce
Bruce एक बहुमुखी ESP32 फ़र्मवेयर है जिसमें offensive-security टूल्स भरे हुए हैं, जिसे Red Team ऑपरेशनों को तेज़ और पोर्टेबल बनाने के लिए बनाया गया है।
यह [M5Stack](https://shop.m5stack.com), [LILYGO](https://lilygo.cc) , [RockBase IoT](https://www.rockbaseiot.com) और [Elecrow](https://www.elecrow.com) उत्पादों को भी सपोर्ट करता है, और Cardputer, Sticks, M5Cores, T-Decks तथा T-Embeds के साथ बढ़िया काम करता है।
## :zap: हमारा आधिकारिक DevKit प्राप्त करें!
# RF REAPER
**RF REAPER** हमारा कस्टम PCB devkit है, जो विशेष रूप से Bruce के लिए बनाया गया है!
हर प्रमुख फीचर नेटिव रूप से, बॉक्स से बाहर ही काम करता है। Sub-GHz, NFC/RFID, IR, 2.4GHz(NRF), GPS-ready, और एक microSD, सभी एक दमदार ESP32-S3 (16MB Flash / 8MB PSRAM) द्वारा संचालित हैं। AW9523 expander के ज़रिए ढेरों GPIOs के साथ-साथ Flipper Zero और iButton header compatibility का मतलब है कि आप इस पर अंतहीन रूप से hack, mod और build कर सकते हैं। कोई विशेष फ़ंक्शन चाहिए? हमसे issue के ज़रिए पूछें, हम जाँच कर लेंगे।
👉 **[RF REAPER और आधिकारिक बोर्ड खरीदें](https://shop.bruce.computer)**
**हमारे पूरी तरह से ओपन-सोर्स हार्डवेयर को भी देखें:** https://bruce.computer/boards
और कस्टम devkit बोर्ड जल्द आ रहे हैं! हमारे समुदायों से जुड़े रहें!
## :building_construction: इंस्टॉल कैसे करें
### Bruce को इंस्टॉल करने का सबसे आसान तरीका हमारे आधिकारिक Web Flasher का उपयोग करना है!
### देखें: https://bruce.computer/flasher
वैकल्पिक रूप से, आप releases या actions से नवीनतम बाइनरी डाउनलोड करके esptool.py का उपयोग करके स्थानीय रूप से flash कर सकते हैं।
```sh
esptool.py --port /dev/ttyACM0 write_flash 0x00000 Bruce-<device>.bin
```
**m5stack डिवाइसों के लिए**
यदि आप पहले से अपने m5stack डिवाइस को मैनेज करने के लिए M5Launcher का उपयोग करते हैं, तो आप इसे OTA के साथ इंस्टॉल कर सकते हैं।
या आप इसे सीधे [m5burner tool](https://docs.m5stack.com/en/download) से burn कर सकते हैं, बस उस डिवाइस category में 'Bruce' (मेरे आधिकारिक builds "owner" द्वारा अपलोड किए जाएंगे और उनमें फ़ोटो होंगी।) खोजें और burn पर क्लिक करें।
## :keyboard: Discord सर्वर
हमसे हमारे [Discord सर्वर](https://discord.gg/WJ9XF9czVT) पर संपर्क करें!
## :bookmark_tabs: विकी
Bruce द्वारा सपोर्ट किए जाने वाले प्रत्येक फ़ंक्शन के बारे में अधिक जानकारी के लिए, [हमारी विकी यहाँ पढ़ें](https://wiki.bruce.computer/)।
साथ ही, [हमारा FAQ पढ़ें](https://wiki.bruce.computer/faq/)
## :computer: फीचर्स की सूची
<details>
<summary><h2>WiFi</h2></summary>
- [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 (एक से अधिक टारगेट)
- [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) (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
</details>
<details>
<summary><h2>BLE</h2></summary>
- [x] [BLE Scan](https://wiki.bruce.computer/features/ble/#ble-scan)
- [x] Bad BLE - Ducky स्क्रिप्ट चलाएँ, [BadUsb](https://wiki.bruce.computer/features/ble/#badble) के समान
- [x] BLE Keyboard - केवल Cardputer और T-Deck
- [x] iOS Spam
- [x] Windows Spam
- [x] Samsung Spam
- [x] Android Spam
- [x] Spam All
</details>
<details>
<summary><h2>RF</h2></summary>
- [x] Scan/Copy
- [x] [Custom SubGhz](https://wiki.bruce.computer/features/rf/#replay-payloads-like-flipper)
- [x] Spectrum
- [x] Jammer Full (आउटपुट में पूर्ण स्क्वेयर वेव भेजता है)
- [x] Jammer Intermittent (आउटपुट में PWM सिग्नल भेजता है)
- [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
</details>
<details>
<summary><h2>RFID</h2></summary>
- [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
</details>
<details>
<summary><h2>IR</h2></summary>
- [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
</details>
<details>
<summary><h2>FM</h2></summary>
- [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)
</details>
<details>
<summary><h2>NRF24</h2></summary>
- [x] [NRF24 Jammer](https://wiki.bruce.computer/features/nrf24/)
- [x] 2.4G Spectrum
- [ ] Mousejack
</details>
<details>
<summary><h2>Scripts</h2></summary>
- [x] [JavaScript Interpreter](https://wiki.bruce.computer/features/js-interpreter/) [श्रेय justinknight93 को](https://github.com/justinknight93/Doolittle)
</details>
<details>
<summary><h2>Others</h2></summary>
- [x] Mic Spectrum
- [x] [QRCodes](https://wiki.bruce.computer/features/others/#qrcodes)
- [x] Custom
- [x] PIX (ब्राज़ील बैंक ट्रांसफर सिस्टम)
- [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 (नए फीचर्स, LittleFS और SDCard)](https://wiki.bruce.computer/features/others/#badusb)
- [x] USB Keyboard - केवल Cardputer और T-Deck
- [x] [iButton](https://wiki.bruce.computer/features/others/#ibutton)
- [x] LED Control
</details>
<details>
<summary><h2>Clock</h2></summary>
- [x] RTC Support
- [x] NTP time adjust
- [x] Manual adjust
</details>
<details>
<summary><h2>Connect (ESPNOW)</h2></summary>
- [x] Send File
- [x] Receive File
- [x] Send Commands
- [x] Receive Commands
</details>
<details>
<summary><h2>Config</h2></summary>
- [x] Brightness
- [x] Dim Time
- [x] Orientation
- [x] UI Color
- [x] Boot Sound on/off
- [x] Clock
- [x] Sleep
- [x] Restart
</details>
## प्रति डिवाइस विशिष्ट फ़ंक्शन, यहाँ उल्लिखित नहीं किए गए फ़ंक्शन सभी के लिए उपलब्ध हैं।
| 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) | :x: | :x: | :x: | :x: | :x: | :ok: | :x: | :x: | :x: | :x: |
| [Smoochiee V2](https://www.pcbway.com/project/shareproject/Bruce_PCB_Smoochiee_d6a0284b.html) | :ok: | :ok: | :x: | :ok: | :x: | :ok: | :x: | :x: | :x: | :x: |
| [ESP32-C5](https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32c5/esp32-c5-devkitc-1/user_guide.html) | :ok: | :ok: | :x: | :ok: | :x: | :x: | :x: | :x: | :x: | :x: |
| [Bruce RF Reaper](https://www.elecrow.com/bruce-pcb-rf-reaper.html) | :ok: | :ok: | :x: | :ok: but w/ ST25R3916 | :x: | :ok: | :ok: | :x: | :ok: | :x: |
| [Elecrow 24B](https://www.elecrow.com/2-4inch-esp32-miner-lcd-display-2pcs-cryptocurrency-solo-miner-with-1000kh-s-hashrate.html) | :ok: | :ok: | :ok: | :ok: | :x: | :ok:¹ | :x: | :x: | :x: | :x:² |
| [Elecrow 3.5"](https://www.elecrow.com/esp-terminal-with-esp32-3-5-inch-parallel-480x320-tft-capacitive-touch-display-rgb-by-chip-ili9488.html) | :ok: | :ok: | :ok: | :ok: | :x: | :ok:¹ | :x: | :x: | :x: | :x:² |
| [NM-CYD-C5 + RF HAT](https://https://rockbase.shop/products/nm-cyd-c5-colorful) | :ok: | :ok: | :x: | :ok: | :x: | :ok: | :ok: | :x: | :ok: | :x: |
² CYD के पास Launcher Compatibility के लिए LITE_VERSION संस्करण है
¹ Core, CYD और StickCs Bad-USB: [यहाँ](https://wiki.bruce.computer/features/others/#badusb)
_LITE_VERSION_: TelNet, SSH, WireGuard, ScanHosts, RawSniffer, Brucegotchi, BLEBacon, BLEScan और Interpreter M5Launcher Compatibility के लिए उपलब्ध नहीं हैं।
## :sparkles: यह क्यों और कैसा दिखता है?
Bruce, Flipper Zero जैसे डिवाइसों पर केंद्रित समुदाय के भीतर एक गहन अवलोकन से उत्पन्न हुआ है। हालाँकि इन डिवाइसों ने offensive security की दुनिया की एक झलक पेश की, लेकिन एक स्पष्ट भावना थी कि इतने महंगे हुए बिना भी कुछ और हासिल किया जा सकता है, विशेष रूप से ESP32 Devices, Lilygo और M5Stack उत्पादों द्वारा प्रदान किए गए मज़बूत और मॉड्यूलर हार्डवेयर इकोसिस्टम के साथ।
अन्य मीडिया [यहाँ](https://github.com/brucedevices/firmware/blob/main/media) पाई जा सकती है।
## :clap: आभार
- [@bmorcelli](https://github.com/bmorcelli) नए core और ढेर सारे नए फीचर्स के लिए, साथ ही कई डिवाइसों पर porting के लिए!
- [@IncursioHack](https://github.com/IncursioHack) RF और RFID मॉड्यूल फीचर्स जोड़ने के लिए।
- [@Luidiblu](https://github.com/Luidiblu) लोगो और UI डिज़ाइन सहायता के लिए।
- [@eadmaster](https://github.com/eadmaster) बहुत सारे फीचर्स जोड़ने के लिए।
- [@rennancockles](https://github.com/rennancockles) बहुत सारे RFID कोड, रीफैक्टरिंग और अन्य फीचर्स के लिए।
- [@7h30th3r0n3](https://github.com/7h30th3r0n3) रीफैक्टरिंग और WiFi अटैक में बहुत सारी मदद के लिए।
- [@Tawank](https://github.com/Tawank) कई अन्य चीज़ों के अलावा इंटरप्रेटर रीफैक्टरिंग के लिए
- @pablonymous RAW Data पढ़ने के लिए RF फ़ंक्शन के लिए
- [Smoochiee](https://github.com/smoochiee) Bruce PCB डिज़ाइन के लिए।
- TH3_KR4K3N Stick cplus extender PCB डिज़ाइन के लिए।
- हर कोई जिसने किसी भी तरह से प्रोजेक्ट में योगदान दिया, धन्यवाद :heart:
Bruce अन्य महान ओपन-सोर्स फ़र्मवेयर प्रोजेक्टों के कंधों पर भी खड़ा है, जिन्होंने प्रोजेक्ट में फीचर्स और कोड को प्रेरित किया:
- [ESP32Marauder](https://github.com/justcallmekoko/ESP32Marauder) by [@justcallmekoko](https://github.com/justcallmekoko) — WiFi/Bluetooth offensive टूलकिट।
- [Launcher](https://github.com/bmorcelli/Launcher) by [@bmorcelli](https://github.com/bmorcelli) — डिवाइसों के लिए मल्टी-ऐप लॉन्चर/बूटलोडर।
- [Evil-M5Project](https://github.com/7h30th3r0n3/Evil-M5Project) by [@7h30th3r0n3](https://github.com/7h30th3r0n3) — M5Stack के लिए WiFi अटैक सूट।
- [M5Stick-Nemo](https://github.com/n0xa/m5stick-nemo) by [@n0xa](https://github.com/n0xa) — M5Stick डिवाइसों के लिए मल्टी-टूल फ़र्मवेयर।
Bruce कई फ्री-सॉफ़्टवेयर लाइब्रेरीज़ पर आधारित है, और RF तथा NFC/RFID मॉड्यूल के कुछ हिस्से अन्य प्रोजेक्टों से लिए गए हैं। थर्ड-पार्टी एट्रिब्यूशन और कॉपीलेफ्ट-अनुपालन विवरण के लिए [THIRD_PARTY.md](https://github.com/brucedevices/firmware/blob/main/THIRD_PARTY.md) देखें।
## :construction: अस्वीकरण
Bruce साइबर offensive और red team ऑपरेशनों के लिए एक टूल है, जिसे Affero General Public License (AGPL) की शर्तों के तहत वितरित किया जाता है। यह केवल कानूनी और अधिकृत सुरक्षा परीक्षण उद्देश्यों के लिए है। इस सॉफ़्टवेयर का किसी भी दुर्भावनापूर्ण या अनधिकृत गतिविधि के लिए उपयोग सख्त वर्जित है। Bruce को डाउनलोड, इंस्टॉल या उपयोग करके, आप सभी लागू कानूनों और विनियमों का पालन करने के लिए सहमत होते हैं। यह सॉफ़्टवेयर निःशुल्क प्रदान किया जाता है, और हम प्रतियों या संशोधनों के लिए भुगतान स्वीकार नहीं करते हैं। Bruce के डेवलपर्स सॉफ़्टवेयर के किसी भी दुरुपयोग के लिए कोई ज़िम्मेदारी नहीं लेते हैं। अपने जोखिम पर उपयोग करें।