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-Deck и T-Embed.
## :zap: Получите наш официальный DevKit!
# RF REAPER
**RF REAPER** — это наш собственный devkit на базе PCB, созданный специально для Bruce!
Все основные функции работают из коробки. Sub-GHz, NFC/RFID, ИК, 2.4GHz (NRF), поддержка GPS и microSD — всё это управляется мощным ESP32-S3 (16MB Flash / 8MB PSRAM). Множество GPIO через расширитель AW9523 плюс совместимость с разъёмами Flipper Zero и iButton означают, что вы можете бесконечно взламывать, модифицировать и дорабатывать его. Нужна конкретная функция? Оставьте 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
```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: Вики
Для получения дополнительной информации о каждой функции, поддерживаемой Bruce, [читайте нашу вики здесь](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 Flood](https://wiki.bruce.computer/features/wifi/#deauth-flood) (более одной цели)
- [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 Sniffer](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] [Опционально] Flood уникальных идентификаторов пиров
</details>
<details>
<summary><h2>BLE</h2></summary>
- [x] [BLE-сканирование](https://wiki.bruce.computer/features/ble/#ble-scan)
- [x] Bad BLE — запуск Ducky-скриптов, аналогично [BadUsb](https://wiki.bruce.computer/features/ble/#badble)
- [x] BLE-клавиатура — только 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] Сканирование/Копирование
- [x] [Пользовательский SubGhz](https://wiki.bruce.computer/features/rf/#replay-payloads-like-flipper)
- [x] Спектр
- [x] Полный глушитель (передаёт полную квадратную волну на выход)
- [x] Прерывистый глушитель (передаёт ШИМ-сигнал на выход)
- [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] Чтение 125кГц
- [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] ИК-приёмник
- [x] [Пользовательский ИК (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 и SDCard)](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] Цвет интерфейса
- [x] Звук загрузки вкл/выкл
- [x] Часы
- [x] Сон
- [x] Перезагрузка
</details>
## Специфические функции по устройствам; функции, не упомянутые здесь, доступны на всех устройствах.
| Устройство | 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: но с 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 существует версия LITE_VERSION для совместимости с Launcher
¹ 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. Хотя эти устройства давали представление о мире offensive security, было ощутимое чувство, что можно добиться большего без таких завышенных цен, особенно с учётом надёжной и модульной аппаратной экосистемы, предоставляемой устройствами 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) за помощь с логотипом и дизайном интерфейса.
- [@eadmaster](https://github.com/eadmaster) за добавление множества функций.
- [@rennancockles](https://github.com/rennancockles) за большое количество кода RFID, рефакторинг и другие функции.
- [@7h30th3r0n3](https://github.com/7h30th3r0n3) за рефакторинг и большую помощь с WiFi-атаками.
- [@Tawank](https://github.com/Tawank) за рефакторинг интерпретатора среди многих других вещей
- @pablonymous за RF-функции для чтения RAW-данных
- [Smoochiee](https://github.com/smoochiee) за дизайн PCB для Bruce.
- TH3_KR4K3N за дизайн PCB удлинителя для Stick cplus.
- Всем, кто так или иначе внёс вклад в проект, спасибо :heart:
Bruce также стоит на плечах других великих проектов с открытым исходным кодом, которые вдохновили функции и код по всему проекту:
- [ESP32Marauder](https://github.com/justcallmekoko/ESP32Marauder) от [@justcallmekoko](https://github.com/justcallmekoko) — набор инструментов для атак WiFi/Bluetooth.
- [Launcher](https://github.com/bmorcelli/Launcher) от [@bmorcelli](https://github.com/bmorcelli) — мультиприложенческий лаунчер/загрузчик для устройств.
- [Evil-M5Project](https://github.com/7h30th3r0n3/Evil-M5Project) от [@7h30th3r0n3](https://github.com/7h30th3r0n3) — набор WiFi-атак для M5Stack.
- [M5Stick-Nemo](https://github.com/n0xa/m5stick-nemo) от [@n0xa](https://github.com/n0xa) — многофункциональная прошивка для устройств M5Stick.
Bruce основан на многих библиотеках свободного ПО, а части модулей RF и NFC/RFID взяты из других проектов. Смотрите [THIRD_PARTY.md](https://github.com/brucedevices/firmware/blob/main/THIRD_PARTY.md) для получения информации об атрибуции третьих лиц и соблюдении условий copyleft.
## :construction: Отказ от ответственности
Bruce — это инструмент для кибернаступательных операций и операций red team, распространяемый на условиях Affero General Public License (AGPL). Он предназначен только для законного и авторизованного тестирования безопасности. Использование этого программного обеспечения в любых вредоносных или несанкционированных целях строго запрещено. Загружая, устанавливая или используя Bruce, вы соглашаетесь соблюдать все применимые законы и нормативные акты. Данное программное обеспечение предоставляется бесплатно, и мы не принимаем платежи за копии или модификации. Разработчики Bruce не несут ответственности за любое неправомерное использование программного обеспечения. Используйте на свой страх и риск.