Skip to content

Repository files navigation

Cyber Controller — Hardware Guides

Buy it, build it, flash it, run it — one printable guide per tool.

Hands-on hardware guides for the firmware and OS targets that Cyber Controller can flash and control. Each one is a full walkthrough — what to buy → how to build it → how to flash & run it → how to wire it into Cyber Controller → troubleshooting — with a downloadable PDF.

License: MIT Stars For Cyber Controller

Cyber Controller · cybercontroller.org · Coverage & backlog · Changelog · Disclaimer · Contributing

Authorized use only. Many of these tools transmit on regulated bands or perform offensive actions (deauth, evil-AP, RF). Use them only on hardware and networks you own or are explicitly authorized to test. Some entries are detector-only or lab-only / illegal-to-operate — each guide says which. Where a fact couldn't be verified it's marked verify: rather than asserted, and purchase links are given as a vendor + search string (never invented). See DISCLAIMER.md for the full terms.

Cyber Controller can flash more targets than are written up here. I add guides as I actually build and run each one, so the set grows over time and stays honest about what it doesn't cover yet. Each guide names the exact Cyber Controller profile and backend, the supported chips/boards, and the upstream project — every count and fact is grounded in the app's shipped profiles.

📄 = download the complete-walkthrough PDF · ⚠ = lab-only / illegal-to-operate · 🛡 = detector/defensive-only

30 guides across 7 categories — a full guide for 26 of Cyber Controller's 51 flash profiles, plus bootable-OS and detector walkthroughs. The profiles still waiting on a guide are tracked in COVERAGE.md.

ESP32

ESP32-family firmware (flashed over USB by Cyber Controller's esptool backend).

Project Chips / Backend Upstream Guide PDF
AirTag Scanner 🛡 esp32, esp32s3 MatthewKuKanich/ESP32-AirTag-Scanner guide 📄
BlueJammer-V2 - ESP32 engine ⚠ esp32 EmenstaNougat/BlueJammer-V2 guide 📄
Bruce esp32, esp32c5, esp32c6, esp32s3 BruceDevices/firmware guide 📄
Chasing Your Tail NG 🛡 esp32 ArgeliusLabs/Chasing-Your-Tail-NG guide 📄
ESP32 Bit Pirate esp32s3 geo-tp/ESP32-Bit-Pirate guide 📄
ESP32 Marauder esp32, esp32c5, esp32s2, esp32s3 justcallmekoko/ESP32Marauder guide 📄
ESP32-DIV esp32, esp32s3 cifertech/ESP32-DIV guide 📄
Flock-You 🛡 esp32s3 colonelpanichacks/flock-you guide 📄
GhostESP esp32, esp32c5, esp32c6, esp32s3 GhostESP-Revival/GhostESP guide 📄
HaleHound esp32 JesseCHale/HaleHound-CYD guide 📄
Hydra32 (ESP32-Deauther) esp32 SameerAlSahab/ESP32-Deauther guide 📄
MCLite (MeshCore) esp32s3 laserir/MCLite guide 📄
Meshtastic esp32s3 meshtastic/firmware guide 📄
MinigotchiV3 esp32, esp32s3 dj1ch/minigotchi-V3 guide 📄
OUI-Spy esp32s3 colonelpanichacks/oui-spy-unified-blue guide 📄
Sky-Spy 🛡 esp32c6, esp32s3 colonelpanichacks/Sky-Spy guide 📄
T-REX esp32s3 abdallahnatsheh/T-REX-FIRMWARE guide 📄

RTL8720

Realtek RTL8720DN / BW16 (AmebaD) — dual-band 2.4/5 GHz, flashed via the rtl8720 backend.

Project Chips / Backend Upstream Guide PDF
BlueJammer-V2 - BW16 controller ⚠ rtl8720 EmenstaNougat/BlueJammer-V2 guide 📄
BW16 Deauther (RTL8720DN) rtl8720 vampel/vampel.github.io guide 📄

Flipper Zero

Flipper Zero custom firmware (Cyber Controller hands the package to qFlipper to install).

Project Chips / Backend Upstream Guide PDF
Flipper Zero - Momentum stm32wb55 Next-Flip/Momentum-Firmware guide 📄
Flipper Zero - Unleashed stm32wb55 DarkFlippers/unleashed-firmware guide 📄

SBC / SD

Single-board-computer images written to a microSD/USB (removable-only writer).

Project Chips / Backend Upstream Guide PDF
Kali Linux ARM sd link guide 📄
Pwnagotchi sd link guide 📄
RaspyJack sd link guide 📄

SBC / ADB

Device firmware installed over ADB.

Project Chips / Backend Upstream Guide PDF
RayHunter 🛡 adb link guide 📄

Software-OS

Bootable PC/USB operating systems (Software-OS tab; SHA-256 + OpenPGP verified).

Project Chips / Backend Upstream Guide PDF
Arch Linux (USB) sd/usb-writer link guide 📄
Kali Linux (USB) sd/usb-writer link guide 📄
Tails OS (USB) sd/usb-writer link guide 📄

Meta

Bring-your-own / utility profiles.

Project Chips / Backend Upstream Guide PDF
Custom / local .bin esptool guide 📄
Jammer Detection 🛡 guide 📄

These guides are MIT-licensed; the firmwares themselves are owned by their respective upstream authors (see each guide's Sources). Vendor links and prices change — verify at purchase time.

Regenerate this index: python tools/build_readme.py · Rebuild PDFs: python tools/build_pdfs.py


📫 Connect


Built by LxveAce · a LxveLabs project. Hardware supported by PCBWay — LxveLabs is developing a custom multi-radio ESP32 board in collaboration with PCBWay.

About

In-depth per-firmware hardware guides (purchase, build, flash, integrate into Cyber Controller, troubleshoot) + downloadable PDFs for every firmware Cyber Controller supports.

Topics

Resources

Code of conduct

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages