ESP32 Marauder — Cheap Yellow Display
The aim of this project is to port the ESP32-Marauder firmware to the Cheap Yellow Display (CYD), offering powerful WiFi and Bluetooth testing features on an affordable and accessible hardware platform.
🏴☠️ Latest Update Highlights — added wardriving to ESP32-1732S019N (05/18/25) 🏴☠️
- Add support for ESP32-1732S019 1.9" ST7789 no touch ESP32-S3
- Select button →
BOOT
- Down button →
GPIO47
- GPS RX →
GPIO17
- GPS TX →
GPIO18
- Add security check to AP scanning
- Add WPS and Manufacturer check for AP scan
- Add more stats to Raw Capture
- Add WiFi analyzer
- Add quick names to channel analyzer graph
- Fix evil portal AP name character limit
- Add packet count function
- Add AP info
- Add Raw Capture
- Add single scan for AP and Stations
- Add generate random MACs for AP and Station WiFi interface
- Fixed sniffer output overlapping
- Reduced memory usage
- Add index number to AP scan display
- Add BLE analyzer
- Add support for ESP32-2432S024C 2.4" ILI9341/CST820 Capacitive Touch
- Add support for ESP32-3248S035C 3.5" ST7796/GT911 Capacitive Touch
- Add support for ESP32-2432S032C 3.2" ST7789/GT911 Capacitive Touch
- Add support for ESP32-2432S032R 3.2" ST7789/XPT2046 Resistive Touch
- Add support for Guition ESP32-2432S024R 2.4" Resistive Touch
- Recalibrate touch for 3.5"
- Fix bluetooth attack LED not turning off
- Fix status LED for bluetooth stuff
- Add support for ESP32-3248S035R 3.5" ST7796/XPT2046 Resistive Touch
- Add support for Adafruit MAX17048 battery monitor
- Update Save/Load Files menu to add for saving and loading AirTags
- Add logging to SD for Flipper/AirTag sniff
- Add Flipper Zero Sniff
- Airtag Sniffing/Spoofing
- Working Pwnagotchi Detect on all models
- Flipper BLE Spam
- Wardriving Menu added
- Added compatibility for ESP32-2432S024R 2.4" Resistive Touch USB Type-C Only
- Guide for antenna modification using ESP-WROOM-32U with built-in IPEX/U.FL
- Evil Portal examples and setup
- How to add an external antenna
Requirements
- A compatible CYD module (see Compatibility)
- Chrome browser
- Data-capable USB cable
- (Optional) GPS module for enhanced functionality
Installation Steps
Web Flasher Method (Recommended)
- Go to the CYM Web Flasher
- Hold BOOT on your device, click “Connect” and select
- Choose the appropriate Model and Version
- Click “Program” to start flashing
Manual Web Flasher Method (for installing old releases)
- Visit the manual flasher
- Hold BOOT, click Connect
- Set memory offset and upload files
- Program
Troubleshooting:
If issues arise, try the following steps:
- Unplug and restart your CYD module
- Hold
RST, tap BOOT, release RST (the screen should go blank)
- Refresh the Web Flasher page and click “Connect”
For further details, check out the Web Flasher repository.
Alternatively, you can flash using esptool.py by:
cd ~
git clone https://github.com/Fr4nkFletcher/Adafruit_WebSerial_ESPTool
esptool.py --port /dev/YOURSERIALPORT write_flash 0x1000 ~/Adafruit_WebSerial_ESPTool/resources/STATIC/M/CYD/esp32_marauder.ino.bootloader.bin \
0x8000 ~/Adafruit_WebSerial_ESPTool/resources/STATIC/M/CYD/esp32_marauder.ino.partitions.bin \
0x10000 ~/Adafruit_WebSerial_ESPTool/resources/CURRENT/esp32_marauder_ofyourchoice.bin
Manual Arduino IDE Method
- Set up your Arduino environment following the ESP32 Marauder Arduino IDE Setup Guide
- Update your platform.txt
- Add the necessary libraries to your Arduino libraries folder
- Set the upload speed to
115200 in the Arduino IDE (tested on version 1.8.19)
- Upload the firmware to your CYD module
For a step-by-step guide, refer to Smoochiee’s tutorial
Compatibility
The project has been successfully tested on:
No hardware modifications are required, thanks to @ggaljoen’s fork of the TFT_eSPI library
GPS Functionality
GPS functionality is fully supported via the 4-pin connector near the MicroUSB port. For a list of compatible GPS hardware, refer to the official wiki
| GPS |
-> |
CYD |
| VCC |
-> |
VIN |
| GND |
-> |
GND |
| TX |
-> |
TX |
| RX |
-> |
RX |
Note: On 2.4" and 3.5" models swap RX/TX
Example Usage
After flashing, you’ll boot into the Marauder interface. Refer to the ESP32 Marauder Wiki for detailed usage instructions
Acknowledgments
A huge thanks to @cod5fgzj, smoochiee, ggaljoen, ATOMNFT, jstockdale, and sorinbotirla. And a special mention to JustCallMeKoko for the foundational work on ESP32Marauder.
Disclaimer
This project is for educational purposes only. Always obtain proper authorization before testing on networks you don’t own or have explicit permission to test. Don’t be a dick!
评论