Flash Marauder on the Flipper WiFi Devboard
Install the latest stable ESP32 Marauder firmware on the official Flipper Zero Wi-Fi Dev Board directly from this page. You need Chrome or Edge on a desktop computer and a USB-C data cable.
Download-mode steps for this board
Unlike boards that can flip themselves into the bootloader over USB control lines, the official Flipper Wi-Fi Dev Board (ESP32-S2, native USB — no auto-reset circuit) must be put into download mode manually before you click Connect. The simplest method, recommended by Flipper, is to hold BOOT while you plug in the cable:
- Press and hold BOOT on the devboard — keep holding it through the next step.
- While still holding BOOT, plug the board into your computer with a USB-C data cable.
- Release BOOT.
- Click Connect and choose the devboard serial port.
If Connect fails before the chip is detected, the board usually did not enter download mode. Unplug it and repeat the hold-BOOT-then-connect sequence. (If the board is already powered and you can't replug it, hold BOOT, tap RESET once, release BOOT, then click Connect.)
What does this flash?
This page uses the Marauder release build for Flipper Zero hardware, the file ending in _flipper.bin. It also writes the bootloader, partition table, and boot app at the offsets documented by the Marauder project:
| File | Offset |
|---|---|
| Bootloader | 0x1000 |
| Partitions | 0x8000 |
| Boot app | 0xE000 |
Marauder firmware (_flipper.bin) | 0x10000 |
How do I use it with Flipper Zero?
After flashing, use the Marauder companion app on your Flipper Zero to talk to the Wi-Fi Dev Board over the GPIO header. Marauder's release notes recommend keeping the companion app updated when using new firmware features.
If the board does not boot back into Marauder immediately after flashing, tap RESET once. On ESP32-S2 hardware, a serial-tool hard reset is not always enough to make the board come back cleanly.
Which browsers can flash it?
| Browser | Supported |
|---|---|
| Chrome / Edge (desktop) | Yes |
| Chrome (Android) | Yes |
| Safari (macOS / iOS) | No |
| Firefox | No |
Browser flashing relies on the Web Serial API, available only in Chromium-based browsers.
Troubleshooting
| Symptom | Fix |
|---|---|
| No port shows in the picker | Use a USB-C data cable and disconnect other serial tools. |
| Failed to connect before the chip is detected | The board did not enter download mode. Unplug it, hold BOOT, plug the cable back in while still holding BOOT, release BOOT, then click Connect again. |
| Flash finishes but the board does not seem to reboot | Tap RESET once to start Marauder manually. |
| Flash completes but Flipper app cannot talk to it | Update the Marauder companion app on the Flipper Zero and power-cycle the Wi-Fi Dev Board. |
| Download / CORS error | The firmware host or proxy is briefly unreachable. Refresh and retry. |
What is ESP32 Marauder?
ESP32 Marauder is an open-source firmware suite for ESP32 devices used in Wi-Fi and Bluetooth research. Source code and releases are published at github.com/justcallmekoko/ESP32Marauder.
Frequently asked questions
How do I put the Flipper WiFi Devboard into download mode?
Hold the BOOT button, plug in the USB-C cable while still holding BOOT, then release BOOT and click Connect. The official ESP32-S2 devboard uses native USB with no auto-reset circuit, so download mode is entered manually.
Why does Connect fail before the chip is detected?
The board did not enter download mode. Unplug it, hold BOOT, plug the cable back in while holding BOOT, release BOOT, then click Connect again. (Already powered? Hold BOOT, tap RESET once, release BOOT, then Connect.)
What firmware does this flash?
The latest stable ESP32 Marauder build for Flipper Zero hardware (the *_flipper.bin asset), written as four files: bootloader at 0x1000, partitions at 0x8000, boot_app0 at 0xE000, and the firmware at 0x10000.
Which browsers can flash the devboard?
Chrome or Edge on a desktop computer (and Chrome on Android). Browser flashing uses the Web Serial API, which Safari and Firefox do not support.
The board doesn't reboot after flashing — what do I do?
Tap RESET once. On ESP32-S2 hardware a serial-tool hard reset is not always enough to restart the board cleanly.
WARNING
For educational and lawful testing purposes only. Comply with all applicable laws in your jurisdiction.