brucedevices/firmware捕食型ESP32ファームウェア
# :shark: Bruce
Bruceは、Red Teamオペレーションを迅速かつポータブルにするために作られた、オフェンシブセキュリティツールを満載した多機能ESP32ファームウェアです。
また、[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**は、Bruceのために特別に設計されたカスタムPCB DevKitです！
主要な機能はすべて、箱から出してすぐにネイティブで動作します。Sub-GHz、NFC/RFID、IR、2.4GHz(NRF)、GPS対応、microSDを、高性能なESP32-S3（16MBフラッシュ / 8MB PSRAM）がすべて駆動します。AW9523エキスパンダー経由の豊富なGPIOに加え、Flipper Zero＆iButtonヘッダーとの互換性により、無限にハック、改造、拡張が可能です。特定の機能が必要ですか？Issueでお知らせください。確認します。
👉 **[RF REAPERと公式ボードを購入](https://shop.bruce.computer)**
**完全オープンソースのハードウェアもチェックしてください:** https://bruce.computer/boards
さらにカスタムDevKitボードが近日登場予定！コミュニティをチェックしていてください！
## :building_construction: インストール方法
### Bruceをインストールする最も簡単な方法は、公式Webフラッシャーを使うことです！
### チェック: https://bruce.computer/flasher
あるいは、releasesまたはactionsから最新のバイナリをダウンロードし、esptool.pyを使ってローカルに書き込むこともできます。
```sh
esptool.py --port /dev/ttyACM0 write_flash 0x00000 Bruce-<device>.bin
```
**m5stackデバイス向け**
すでにM5Launcherでm5stackデバイスを管理している場合は、OTAでインストールできます。
または、[m5burnerツール](https://docs.m5stack.com/en/download)から直接書き込むこともできます。対象のデバイスカテゴリで'Bruce'を検索し（私の公式ビルドは"owner"によってアップロードされ、写真付きです）、burnをクリックするだけです。
## :keyboard: Discordサーバー
[Discordサーバー](https://discord.gg/WJ9XF9czVT)でお問い合わせください！
## :bookmark_tabs: Wiki
Bruceがサポートする各機能の詳細については、[こちらのWikiをご覧ください](https://wiki.bruce.computer/)。また、[FAQもご覧ください](https://wiki.bruce.computer/faq/)
## :computer: 機能一覧
<details>
<summary><h2>WiFi</h2></summary>
- [x] WiFiに接続
- [x] WiFi AP
- [x] WiFi切断
- [x] [WiFi攻撃](https://wiki.bruce.computer/features/wifi/#wifi-atks)
- [x] [Beaconスパム](https://wiki.bruce.computer/features/wifi/#beacon-spam)
- [x] [ターゲット攻撃](https://wiki.bruce.computer/features/wifi/#target-atks)
- [x] 情報
- [x] ターゲットDeauth
- [x] EvilPortal + Deauth
- [x] Deauthフラッド（複数のターゲット）
- [x] [ワードライビング](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スニファ](https://wiki.bruce.computer/features/wifi/#raw-sniffer)
- [x] [TCPクライアント](https://wiki.bruce.computer/features/wifi/#client-tcp)
- [x] [TCPリスナー](https://wiki.bruce.computer/features/wifi/#listen-tcp)
- [x] [Evil Portal](https://wiki.bruce.computer/features/wifi/#evil-portal)
- [x] [ホストスキャン](https://wiki.bruce.computer/features/wifi/#scan-hosts)（TCPポートスキャン付き）
- [x] [Responder](https://wiki.bruce.computer/features/wifi/#responder)
- [x] [ARPスプーフィング](https://wiki.bruce.computer/features/wifi/#arp-spoofing)
- [x] [ARPポイズニング](https://wiki.bruce.computer/features/wifi/#arp-poisoning)
- [x] [WireGuardトンネリング](https://wiki.bruce.computer/features/wifi/#wireguard-tunneling)
- [x] Brucegotchi
- [x] Pwnagotchiフレンド
- [x] Pwngridスパムの顔と名前
- [x] [オプション] 非常に長い名前と顔をDoScreen
- [x] [オプション] ユニークなピア識別子をフラッディング
</details>
<details>
<summary><h2>BLE</h2></summary>
- [x] [BLEスキャン](https://wiki.bruce.computer/features/ble/#ble-scan)
- [x] Bad BLE - [BadUsb](https://wiki.bruce.computer/features/ble/#badble)と同様のDuckyスクリプトを実行
- [x] BLEキーボード - CardputerとT-Deckのみ
- [x] iOSスパム
- [x] Windowsスパム
- [x] Samsungスパム
- [x] Androidスパム
- [x] すべてにスパム
</details>
<details>
<summary><h2>RF</h2></summary>
- [x] スキャン/コピー
- [x] [カスタムSubGhz](https://wiki.bruce.computer/features/rf/#replay-payloads-like-flipper)
- [x] スペクトラム
- [x] フルジャマー（出力に完全な矩形波を送信）
- [x] 間欠ジャマー（出力にPWM信号を送信）
- [x] 設定
- [x] RF TXピン
- [x] RF RXピン
- [x] RFモジュール
- [x] RF433 T/R M5Stack
- [x] [CC1101 (Sub-Ghz)](https://wiki.bruce.computer/features/rf/#cc1101)
- [x] RF周波数
- [x] リプレイ
</details>
<details>
<summary><h2>RFID</h2></summary>
- [x] タグの読み取り
- [x] 125kHzの読み取り
- [x] タグのクローン
- [x] NDEFレコードの書き込み
- [x] Amiibolink
- [x] Chameleon
- [x] データの書き込み
- [x] データの消去
- [x] ファイルの保存
- [x] ファイルの読み込み
- [x] 設定
- [x] [RFIDモジュール](https://wiki.bruce.computer/features/rfid/#supported-modules)
- [x] PN532
- [x] PN532Killer
- [ ] タグのエミュレート
</details>
<details>
<summary><h2>IR</h2></summary>
- [x] TV-B-Gone
- [x] IRレシーバー
- [x] [カスタムIR (NEC, NECext, SIRC, SIRC15, SIRC20, Samsung32, RC5, RC5X, RC6)](https://wiki.bruce.computer/features/ir/#replay-payloads-like-flipper)
- [x] 設定 - [X] Ir TXピン - [X] Ir RXピン
</details>
<details>
<summary><h2>FM</h2></summary>
- [x] [標準放送](https://wiki.bruce.computer/features/fm/#broadcast-standard)
- [x] [予約放送](https://wiki.bruce.computer/features/fm/#broadcast-standard)
- [x] [放送停止](https://wiki.bruce.computer/features/fm/#broadcast-stop)
- [ ] [FMスペクトラム](https://wiki.bruce.computer/features/fm/#fm-spectrum)
- [ ] [交通情報のハイジャック](https://wiki.bruce.computer/features/fm/#hijack-ta)
- [ ] [設定](https://wiki.bruce.computer/features/fm/#bookmark_tabs-config)
</details>
<details>
<summary><h2>NRF24</h2></summary>
- [x] [NRF24ジャマー](https://wiki.bruce.computer/features/nrf24/)
- [x] 2.4Gスペクトラム
- [ ] Mousejack
</details>
<details>
<summary><h2>スクリプト</h2></summary>
- [x] [JavaScriptインタープリター](https://wiki.bruce.computer/features/js-interpreter/) [クレジット: justinknight93](https://github.com/justinknight93/Doolittle)
</details>
<details>
<summary><h2>その他</h2></summary>
- [x] マイクスペクトラム
- [x] [QRコード](https://wiki.bruce.computer/features/others/#qrcodes)
- [x] カスタム
- [x] PIX（ブラジルの銀行振込システム）
- [x] [SDカードマネージャー](https://github.com/pr3y/Bruce/wiki/Others#sd-card-mngr)
- [x] 画像表示 (jpg)
- [x] ファイル情報
- [x] [Wigleアップロード](https://wiki.bruce.computer/features/gps/#how-to-use-wigle)
- [x] オーディオ再生
- [x] ファイル表示
- [x] LittleFSマネージャー
- [x] [WebUI](https://wiki.bruce.computer/controlling-device/webui/)
- [x] サーバー構造
- [x] HTML
- [x] SDカードマネージャー
- [x] Spiffsマネージャー
- [x] Megalodon
- [x] [BADUsb（新機能、LittleFSとSDカード）](https://wiki.bruce.computer/features/others/#badusb)
- [x] USBキーボード - CardputerとT-Deckのみ
- [x] [iButton](https://wiki.bruce.computer/features/others/#ibutton)
- [x] LED制御
</details>
<details>
<summary><h2>時計</h2></summary>
- [x] RTCサポート
- [x] NTP時刻調整
- [x] 手動調整
</details>
<details>
<summary><h2>接続 (ESPNOW)</h2></summary>
- [x] ファイル送信
- [x] ファイル受信
- [x] コマンド送信
- [x] コマンド受信
</details>
<details>
<summary><h2>設定</h2></summary>
- [x] 輝度
- [x] 調光時間
- [x] 向き
- [x] UIカラー
- [x] 起動音オン/オフ
- [x] 時計
- [x] スリープ
- [x] 再起動
</details>
## デバイスごとの特定機能。ここに記載されていない機能はすべてのデバイスで利用可能です。
| デバイス | CC1101 | NRF24 | FMラジオ | PN532 | マイク | BadUSB | RGB Led | スピーカー | バッテリー残量計 | LITE_VERSION |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----: | :---: | :------: | :------------------: | :--: | :----: | :-----: | :-----: | :--------: | :----------: |
| [M5Stack Cardputer](https://shop.m5stack.com/products/m5stack-cardputer-kit-w-m5stamps) （および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) （[および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: ただし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互換用の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互換のため利用できません
## :sparkles: なぜ作られたのか、そしてどんな見た目なのか？
Bruceは、Flipper Zeroのようなデバイスに注目するコミュニティ内での鋭い観察から生まれました。これらのデバイスはオフェンシブセキュリティの世界を垣間見せてくれましたが、それほど高価でなくても、特にESP32デバイス、Lilygo、M5Stack製品が提供する堅牢でモジュール式のハードウェアエコシステムを用いれば、より多くのことを実現できるという実感がありました。
その他のメディアは[こちら](https://github.com/brucedevices/firmware/blob/main/media)で見つけられます。
## :clap: 謝辞
- [@bmorcelli](https://github.com/bmorcelli) 新しいコアと多数の新機能の追加、そして多くのデバイスへの移植に感謝！
- [@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データを読み取るRF機能に感謝。
- [Smoochiee](https://github.com/smoochiee) BruceのPCB設計に感謝。
- TH3_KR4K3N Stick cplusエクステンダーPCB設計に感謝。
- プロジェクトに何らかの形で貢献してくれたすべての人に感謝します :heart:
Bruceはまた、プロジェクト全体の機能とコードに影響を与えた他の優れたオープンソースファームウェアプロジェクトの上に成り立っています：
- [ESP32Marauder](https://github.com/justcallmekoko/ESP32Marauder) by [@justcallmekoko](https://github.com/justcallmekoko) — WiFi/Bluetooth攻撃ツールキット。
- [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は、Affero General Public License（AGPL）の条件の下で配布される、サイバー攻撃およびレッドチームオペレーション用のツールです。合法的かつ承認されたセキュリティテストの目的のみを対象としています。本ソフトウェアを悪意のある目的や許可のない活動に使用することは固く禁止されています。Bruceをダウンロード、インストール、または使用することにより、適用されるすべての法律および規制を遵守することに同意したものとみなされます。本ソフトウェアは無料で提供され、コピーや改変に対して対価を受け取ることはありません。Bruceの開発者は、本ソフトウェアの誤用について一切の責任を負いません。自己責任で使用してください。