Install
- Display
- —
- MCU
- —
- Battery
- —
- GPS
- —
- Firmware
- —
Procedure
- Connect the board to your computer over USB.
- Select your hardware above. A wrong pick leaves the screen blank or scrambled — harmless, just re-flash.
- Press Flash firmware and choose the serial port in the browser prompt.
- Wait for the write to finish, roughly 90–150 seconds.
- The board reboots into Marauder on its own.
What this build changes
Everything upstream Marauder does, plus hardware support for the CYD battery mod:
- Battery percentage in the status bar, read from a MAX17048 fuel gauge on CN1
- GPS relocated to the bottom port (P5) so the fuel gauge can occupy CN1
- A separate build for panels that come up with inverted colours
- No serial CLI — the GPS UART claims those pins, so everything is driven from the touchscreen
WiGLE upload
Wardrive logs go from the SD card to WiGLE over WiFi with no computer in between. Since this build has no CLI, credentials are supplied on the card:
| File on SD root | Contents |
|---|---|
/wigle_api_name.txt | WiGLE API name |
/wigle_api_token.txt | WiGLE API token |
- Place both files on the card and boot — they are read into settings, then deleted.
- Join a network from
WiFi → General → Join WiFi. - Upload from
WiFi → General → Upload Wardrive Logs.
.wigle sidecar written beside them, so repeat runs skip
anything already sent.
Credit
justcallmekoko
Created and maintains ESP32 Marauder, the firmware everything here is built on. This fork tracks his releases; the current base is v1.14.1. All of the scanning, attack, and wardriving work is his.
Hedge (CodeHedge)
Built the CYD variant this repository continues: MAX17048 fuel gauge support, the GPS move to the bottom port, the inverted-display build, and the original CYD web flasher. Every CYD-specific change here started as his work.
This fork
Keeps Hedge's CYD build current with upstream and publishes the firmware served by this page. Hardware pairing: ESP32 Marauder Battery Mod Kit.