kolegaliterat / fzeasymarauderflash

Easily Flash Marauder onto the Flipper Zero Devboard or an ESP32!

Easy Flipper Zero Marauder Flash

This is for easily flashing Marauder on an ESP32 or WiFi Devboard for a Flipper Zero!

Windows Users:

You have two prerequisites. You must install Git for Windows from here.
If you are flashing an ESP32 board, you need to install the driver from here in order for your device to be recognized

It is now simple to install or update Marauder on Linux, Mac OS X, or Windows.

How to use:

• Step 0 only has to be ran once

0. run pip3 install -r requirements.txt.
1. Connect the devboard or ESP32 board via USB.
2. Press and hold the BOOT button on the module, press and release the RESET button.
3. Release the BOOT button.
4. run python3 EasyInstall.py.
5. Select the option of what you want to do

• Important note: You may need to run this script with sudo or as Administrator in Windows

This project is based on the Windows Marauder flasher batch script

You can find it here in UberGuidoZ's repo

About this script

This script pulls all of its resources from the proper Github repositories in order to make sure you are up-to-date.
The only dependencies it does not get by itself are the required Python modules and Windows tools.
This script should work on most devices that can run Python 3 and can access serial ports via USB.
Thanks to Marauder update v0.10.2 and Marauder Companion Flipper Zero app fork/update from tcpassos PCAPs can now be directly saved to your Flipper Zero's SD Card directly!

Compatible boards

• Flipper Zero WiFi Devboard
• ESP32-S2 (The ESP32 chip that is on the WiFi Devboard)
• ESP32-S2-WROVER
• ESP32-WROOM
• ESP32-WROOM D1 Mini
• ESP32-S3

How to connect an ESP32-WROOM, WROVER, etc to the Flipper Zero

ESP32 -> Flipper Zero
TX0 -> RX
RX0 -> TX
GND -> GND
3v3 -> 3v3

TODO:

• Code cleanup.
• Add more chip compatibility.
• Attempt to accommodate 3rd-party knock-off chips that are not from Espressif

Acknowledgements:

Disclaimer: Includes Acknowledgements from the above linked repo from UberGuidoz as this wouldn't exist without the original project

• justcallmekoko for the AWESOME work in developing Marauder and porting it to the Flipper.
• 0xchocolate for the Marauder companion plugin (now in Unleashed and RogueMaster.)
• Frog For initial scripting under the Wifi Pentest Tool and inspiring the idea.
  
• ImprovingRigmarole Initial (and continued) scripting of the batch Windows Marauder flasher and lots of testing.
  
• UberGuidoZ Tweaking/Automating Frog's original, continued scripting, development, and testing.
• L0rd_K0nda from the Unleashed Flipper Zero Discord for testing this script for me
• SkeletonMan Creating this Python flasher in order to try to make a multi-os flasher since the Batch script obviously could not run on Linux or Mac OS X
• CorbanR Forking and fixing instructions and adding a requirement needed for Mac OS X
• dchalm Forking and fixing mistakes I should have noticed. Thank you!
• Scorp Compiling needed bins to be able to flash to ESP32-WROOM
• jacklythgoee For getting a knockoff ESP32-WROOM and giving me info to be able to try to detect it so it could be flashed.
• Der Skythe For fixing extra quotes I added without noticing and his awesome work on Flipper Zero Firmware
• seeker7r4c3r For adding the VID of the DrB0rk S3 Multiboard
• aafksab For fixing the Windows bug with the update option that was confusing me