Flipper Zero
If at any moment you need further guidance, consider joining the discord server.
The Flipper Zero features a GPIO header on the top edge of it's body. This header is able to accommodate many different peripheral devices including ESP32 modules and development boards. Because of it's many available protocols, the Flipper Zero is able to communicate directly with the ESP32 Marauder firmware when it is properly installed on a compatible ESP32 expansion board. All that is requires is to install the ESP32 Marauder firmware on a compatible ESP32 development board, install the necessary application files on your Flipper Zero, connect your ESP32 development board to the Flipper Zero, and begin using the Marauder firmware features.
The following documentation describes the steps necessary to install the ESP32 Marauder firmware on your ESP32 peripheral device as well as the applications necessary to prepare your Flipper Zero to interface with the Marauder firmware.
Install anyone of the following third party firmwares on your Flipper Zero. They come prebuilt with the WiFi Marauder app created by 0xchocolate. This application allows you to control the Marauder firmware from your Flipper Zero user interface. Simply find the WiFi Marauder application in your Flipper Zero application directory and execute it with your ESP32 expansion plugged into your Flipper Zero.
- Momentum (recommended)
- Unleashed
- Xtreme
- RogueMaster
| Blue pill | Red Pill |
|---|---|
| Really easy. Nothing to change, but you don't get any customization (which is fine). | This pill is the size of a large pumpkin and it goes in your ass. Install libraries, build from source, know everything |
| Spacehuhn Web Installer, FZ Marauder Flasher, or FZEasyMarauderFlash | Build from source |
If you are having issues with your Marauder installation either with the install process or with the firmware usage, be sure to check if your issue has already been solved in FAQ. If not, feel free to join my Discord to request help from the community or submit an issue
Note: We now offer a dedicated SD adapter and SD/GPS adapter board for a clean install on the Flipper Zero WiFi Dev Board. No wires are necessary.
A MicroSD card can be attached to the Flipper Zero WiFi Dev Board SPI via a MicroSD Breakout. Attaching a microSD card to the Flipper Zero WiFi Dev Board will allow the Marauder firmware to save captured WiFi traffic to storage in the form of PCAP files to be exported for analysis later. If you install this mod, DO NOT use the flipper_sd_serial.bin to update your WiFi Dev Board. Refer to the following table for the required solder connections
| MicroSD Breakout | Flipper Zero WiFi Dev Board |
|---|---|
| VCC | 3V3 |
| GND | GND |
| DI (MOSI) | IO35 |
| DO (MISO) | IO37 |
| SCK | IO36 |
| CS | IO10 |
Once all of the solder connections have been made, a piece of double-sided tape can be used to fix the MicroSD Breakout Board to the back of the WiFi Development Board.
This video by Lab 401 will provide instructions for using the flasher script. This is the quickest way to get Marauder running on your device
The following video describes and demonstrates the installation and usage of the Marauder firmware on the Flipper Zero WiFi Dev Board.
If you're trying to figure out what to do now that you have Marauder installed on your Flipper Zero, consider reading Commandline for how to use the Marauder command line interface, and Workflow Examples to understand how to use some of the commands in a practical way.