← How-Tos
flipper-zero Mar 26, 2026 ◑ 8 views ◯ 1 min read

Setting Up Marauder on the ESP32 Wi-Fi Dev Board for Flipper

flipper zeroesp32marauderwifisecurity

Marauder is the most popular firmware for the Flipper Wi-Fi Dev Board. Here's the complete setup process.

What You Need

Step 1 โ€” Download Marauder

  1. Go to: github.com/justcallmekoko/ESP32Marauder/releases
  2. Download the latest esp32_marauder_[version]_flipper_wifi_dev_board.bin
  3. This is specifically built for the Flipper dev board hardware

Step 2 โ€” Flash via Web Flasher (Easiest)

  1. Visit: https://esp.huhn.me (ESP32 Web Flasher)
  2. Connect Dev Board via USB while holding the BOOT button
  3. Release BOOT after connecting
  4. Select COM port in web flasher
  5. Upload the .bin file at offset 0x0
  6. Click Flash โ€” takes about 60 seconds

Step 3 โ€” Install Flipper App

  1. Visit lab.flipper.net/apps
  2. Search "Marauder"
  3. Install ESP32 WiFi Marauder Companion to Flipper

Step 4 โ€” Connect Dev Board to Flipper

Mount board onto Flipper GPIO header (pins align to back of Flipper).

Step 5 โ€” Using Marauder

Open the app on Flipper โ†’ connect to board via UART:

Menu ItemFunction
Scan APsList nearby Wi-Fi networks
Scan StationsList connected devices
Beacon SpamBroadcast fake SSIDs
DeauthDeauthenticate clients (own network testing only)
SniffCapture packets to SD card
PMKIDCapture handshake for WPA testing

Saving Captured Data

Captured .pcap files save to SD/apps_data/marauder/. Download via qFlipper for analysis in Wireshark.

Legal Reminder

Deauth attacks and packet sniffing on networks you don't own or have written permission to test are illegal in most jurisdictions. Use only for security testing of your own infrastructure.