BloodMoon — WiFi Scanner and Deauth Tool on LILYGO T-QT Pro
A Marauder-inspired wireless security toolkit for the LILYGO T-QT Pro that scans nearby WiFi access points and stations, displays beacon frame details, and performs deauthentication attacks — all on a 0.85" display with two-button navigation.
Overview
BloodMoon is a custom firmware for the LILYGO T-QT Pro inspired by the ESP32 Marauder project. It turns the tiny ESP32-S3 device into a portable 2.4 GHz wireless reconnaissance and testing tool. The 0.85" LCD displays scan results and the two hardware buttons provide navigation.
Features
- WiFi Scanner — detects nearby access points and their clients (stations), showing BSSID, channel, encryption type, and other beacon frame data
- Deauthentication Attack — target single or multiple APs simultaneously for security testing; multi-select support
- 2.4 GHz Jamming — disrupt 2.4 GHz wireless signals via an attached nRF24L01 module (optional hardware add-on)
Supported Devices
- LILYGO T-QT Pro (ESP32-S3)
- LILYGO T-Display S3 (ESP32-S3)
Technical Details
Built with the Arduino IDE using the esp32 2.0.10 boards package and TFT_eSPI 2.5.4 for display rendering. A custom User_Setup.h for T-QT Pro is included in the repo. Pre-built binaries are available in the test_bins/ directory for flashing via the ESP Tool web flasher without any build toolchain. The optional nRF24L01 jamming module's pins are configurable in settings.h.
