How to Install Marauder Firmware on Flipper Zero WiFi Devboard (2026 Guide)
Partager
If you've picked up a Flipper Zero and want to unlock its full wireless security potential, flashing Marauder firmware onto your WiFi Devboard (ESP32-S2) is the move. This guide is based on the latest release (Marauder v1.12.0) and walks you through the complete setup — no prior coding experience required.
What Is Marauder Firmware?
ESP32 Marauder is an open-source firmware created by security researcher justcallmekoko, built specifically for ESP32-based chips. It bundles a comprehensive suite of WiFi and Bluetooth auditing tools into one package: scanning nearby access points and connected clients, capturing PMKID/WPA handshakes (exportable as .pcap files for Wireshark analysis), sending deauthentication frames, running an Evil Portal captive hotspot, and more. Once flashed onto the Flipper Zero official WiFi Devboard (which runs an ESP32-S2 chip), your Flipper becomes a pocket-sized wireless security assessment platform.
⚠️ Legal Disclaimer: Marauder firmware and the information in this guide are intended strictly for lawful, authorized security research and educational use only. Performing deauth attacks, packet captures, or any offensive actions against networks you do not own or have explicit written permission to test is illegal in most jurisdictions. Always test in a controlled, authorized environment.
What You'll Need
Before getting started, make sure you have everything on this list:
| Item | Notes |
|---|---|
| Flipper Zero | Recommended: a third-party firmware that includes the Marauder companion app (see below) |
| Wi-Fi Devboard (ESP32-S2, Marauder edition) | → View Product Page — the official Flipper Zero WiFi Devboard |
| USB-C cable | Must support data transfer — charging-only cables will not work |
| Chrome or Edge browser | Web Flasher relies on the Web Serial API; Firefox and Safari are not supported |
| Stable internet connection | Required to access fzeeflasher.com |
A note on Flipper firmware: The Marauder companion app (developed by 0xchocolate) comes pre-installed on popular third-party Flipper firmwares including Unleashed, RogueMaster, Xtreme, and Momentum. If you're running official Flipper firmware, you'll need to install esp32_wifi_marauder.fap manually via Flipper Lab.
Method 1: Web Flasher via fzeeflasher.com (Recommended)
This is the easiest, fastest, and most beginner-friendly approach — no software installation required, everything runs inside your browser. The site currently supports Marauder v1.12.0 and covers virtually all popular ESP32 expansion boards.
Step 1: Put the Devboard into DFU (Bootloader) Mode
- Disconnect the WiFi Devboard from your Flipper Zero. Connect it directly to your computer using the USB-C cable — plug into the Devboard's own USB-C port, not the Flipper Zero's.
- Press and hold the BOOT button on the Devboard.
- While holding BOOT, press and release the RESET button.
- Release the BOOT button.
The board is now in DFU mode. On Windows, Device Manager should show a new entry: USB JTAG/serial debug unit. On macOS/Linux, run ls /dev/tty.* in Terminal to confirm a new serial port has appeared.
💡 Board not showing up? Try swapping to a different USB-C cable first (confirm it supports data transfer). If Windows still doesn't recognize it, install the CP210x USB driver from Silicon Labs and try again.
Step 2: Open fzeeflasher.com and Connect
- Open fzeeflasher.com in Chrome or Edge.
- Click the "Connect" button. Your browser will display a serial port picker popup.
- Select "USB JTAG/serial debug unit" (the standard identifier for ESP32-S2) and click Connect.
Once connected, the log area at the bottom of the page should output:
Chip type ESP32-S2
Confirm the chip type is correct before proceeding.
Step 3: Select Your Firmware
Use the three dropdown menus at the top of the page:
-
Select Board:
Flipper Dev Board← choose this for the official WiFi Devboard -
Version:
Latest(currently v1.12.0) -
Firmware:
Marauder
Step 4: Flash
- Click "Program" and wait. The process takes roughly 2–4 minutes — don't disconnect the USB cable.
- When the log reads
---> FLASHING PROCESS COMPLETED!, you're done. - Press the RESET button on the Devboard to reboot it and exit DFU mode.
- Plug the Devboard back into the Flipper Zero's GPIO expansion slot.
Method 2: Flash Directly from Flipper Zero (No Computer Needed)
If your Flipper Zero is already running Unleashed, RogueMaster, Xtreme, or Momentum, you can flash Marauder directly from the device itself using the built-in ESP Flasher app — no computer required.
⚠️ Compatibility note: Starting with Marauder v0.13.7, the firmware ships as a single unified
.binfile. However, using it requires Marauder Companion App v7.0 or higher on your Flipper. Make sure your app is up to date before flashing.
① Download the firmware to your SD card
Head to the ESP32 Marauder GitHub Releases page. In the latest release's Assets section, download the file ending in _flipper.bin — that's the correct build for the official WiFi Devboard. Copy it to your Flipper Zero's SD card under /apps_assets/esp32_wifi_marauder/ (create the folder if it doesn't exist).
② Open the ESP Flasher app
Plug the Devboard into your Flipper Zero, then navigate to: Apps → GPIO → [ESP32] WiFi Marauder → Update Firmware (Exact path may vary slightly depending on your firmware version; look for ESP Flasher if the above doesn't appear.)
③ Select and flash
Choose Manual Flash, browse to the .bin file on your SD card, and confirm with OK. The process takes around 3–5 minutes — keep your Flipper above 50% battery. The Devboard will reboot automatically once flashing is complete.
Verify the Installation
Once flashed, follow these steps to confirm everything is working:
- Make sure the WiFi Devboard is firmly seated in the Flipper Zero's expansion slot.
- On your Flipper, navigate to: Apps → GPIO → [ESP32] WiFi Marauder.
- Select Scan → APs and wait a moment for Marauder to begin scanning.
- If you see a live list of nearby WiFi networks — with SSIDs, MAC addresses, and signal strength — the installation is working perfectly.
Check your firmware version: Go to the Reboot option inside the app. When the Devboard restarts, it outputs the current firmware version number in the Flipper's serial log, which you can cross-reference against the latest GitHub release.
✅ Seeing that WiFi scan list? You're all set.
Common Errors & Fixes
| Error / Symptom | Likely Cause | Fix |
|---|---|---|
| Browser serial port list is empty | Charging-only USB-C cable | Swap to a data-capable cable; try a different USB port on your machine |
| Flash progress stuck at 0% | Didn't enter DFU mode correctly | Redo the BOOT + RESET sequence: hold BOOT → press RESET → release RESET → release BOOT |
Failed to connect to ESP32 |
Missing Windows serial driver | Install the CP210x USB driver, restart your computer, and retry |
Web Serial is not supported |
Wrong browser | Switch to Chrome or Edge — Firefox and Safari do not support the Web Serial API |
| Flipper doesn't detect the Devboard | Companion app version too old | Update esp32_wifi_marauder.fap to v7.0+ (required for v0.13.7+ firmware) |
| Scan does nothing / app freezes | Firmware and app version mismatch | Update both the Devboard firmware and the Flipper app to their latest versions simultaneously |
| Can't save PCAP files | Devboard has no onboard SD card slot | You'll need an additional MicroSD Breakout module and the _flipper_sd_serial.bin firmware variant |
Wrapping Up
The fastest path to getting Marauder running on your Flipper Zero WiFi Devboard is fzeeflasher.com — no command line, no driver headaches, just select your board, hit Program, and you're done in minutes. If you'd rather do everything offline, the ESP Flasher app built into most third-party Flipper firmwares handles the whole process straight from the device.
Don't have a WiFi Devboard yet? Grab one here: Wi-Fi Devboard for Flipper Zero (ESP32-S2, Marauder Edition) →
Drop a comment below if you run into any issues — we'll keep this guide updated as Marauder continues to evolve.
Last updated: May 2026 | Firmware: ESP32 Marauder v1.12.0 | Requires Companion App v7.0+ Sources: ESP32 Marauder Official Wiki · Flipper Community Wiki · FZEEFlasher Wiki