Fr4nkFletcher/ESP32-Marauder-Cheap-Yellow-Display

Free

ESP32Marauder Cheap Yellow Display

FreeFree tier

Type

Open Source

Visit Website GitHub (38 stars)

About Fr4nkFletcher/ESP32-Marauder-Cheap-Yellow-Display

ESP32 Marauder — Cheap Yellow Display (CYD) is an open-source firmware port that brings the extensive WiFi and Bluetooth testing capabilities of the ESP32-Marauder project to affordable CYD hardware modules. It enables security researchers, hobbyists, and penetration testers to perform wardriving, packet capture, evil portal attacks, Flipper Zero sniffing, AirTag sniffing/spoofing, BLE analysis, and more through a graphical interface on color touchscreen displays. The project supports multiple CYD variants (resistive and capacitive touch) and includes features like WiFi analyzer, AP scanning with security/WPS/manufacturer checks, raw capture, Pwnagotchi detection, and battery monitoring via optional modules. Installation is simplified via a web flasher or esptool.py.

Key Features

Wardriving with GPS support (gathered via external GPS module)

WiFi analyzer with channel graph and packet count

BLE (Bluetooth Low Energy) analyzer and BLE spam (Flipper BLE Spam)

Evil Portal creation with custom AP names and captive portal examples

Flipper Zero Sniff and AirTag sniffing/spoofing

Pwnagotchi detection across all supported CYD models

AP scanning with security check, WPS and manufacturer info display

Raw packet capture for WiFi and Bluetooth

Support for multiple CYD variants (ESP32-1732S019, ESP32-2432S024C, 3248S035C, 2432S032C, 2432S032R, 2432S024R, 3248S035R)

Support for Adafruit MAX17048 battery monitor

Pros & Cons

Pros

Runs on very affordable hardware (Cheap Yellow Display modules)
Open source with active development and frequent updates
Comprehensive set of WiFi and Bluetooth attack and analysis tools
Graphical user interface via the CYD touchscreen
Easy installation via web flasher (browser-based, no toolchain needed)
Support for multiple display sizes and touch types (resistive/capacitive)
Extensible with external GPS and battery monitor modules
Detailed documentation and community support on GitHub

Cons

Requires specific Cheap Yellow Display hardware (not compatible with all ESP32 boards)
Intended for security testing; improper use could be illegal
Setup requires some technical knowledge (flashing firmware, wiring GPS if used)
Limited processing power and memory compared to dedicated tools
Some features (e.g., GPS, battery monitor) require additional modules
No official support for non-CYD platforms

Best For

WiFi penetration testing and security auditing on a budgetBluetooth vulnerability assessment and device discoveryWardriving to map WiFi networks and access pointsDeploying captive portal evil twins for phishing demonstrationsSniffing and spoofing Apple AirTags for security researchDetecting Flipper Zero devices in the vicinityEducational projects in wireless security and IoT hackingTesting network security in controlled environments

FAQ

What hardware is required to run this firmware?

A compatible Cheap Yellow Display (CYD) module. Supported models include ESP32-1732S019, ESP32-2432S024C, ESP32-3248S035C, ESP32-2432S032C, ESP32-2432S032R, ESP32-2432S024R, ESP32-3248S035R, and Guition ESP32-2432S024R. An optional GPS module can be added for wardriving.

How do I install the firmware?

The recommended method is to use the CYM Web Flasher. Hold the BOOT button on the device, click 'Connect' in the web flasher, select the correct model and version, then click 'Program'. Alternatively, you can use the manual flasher or esptool.py from the command line.

Does this firmware support external antennas?

Yes, an antenna modification guide is provided for using the ESP-WROOM-32U module with built-in IPEX/U.FL connector for an external antenna.

Can I use this for illegal activities?

No, this firmware is intended for educational and authorized security testing only. Unauthorized use against networks or devices you do not own is illegal.