ESP32-Marauder-Cheap-Yellow-Display

Open source

ESP32Marauder Cheap Yellow Display

1.7K stars0 likes0 views

About

ESP32Marauder Cheap Yellow Display

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

Offset	->	Bin
0x1000	->	Bootloader
0x8000	->	Partitions
0x10000	->	Firmware

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:

bash

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!