Table of Contents
Source: https://github.com/justcallmekoko/ESP32Marauder/wiki/cli – Just Call Me Koko
Marauder Command Line Interface
Every Marauder has the ability to offer a commandline interface. Official Marauder hardware or any ESP32 development board with a USB port can simply be interfaced via USB cable. The Marauder CLI allows for complete control of the firmware and will provide the user with the full capabilities of Marauder.
For full usage on how to establish a connection to the Marauder command line interface, see Access CLI below. If you would like to see examples of how these commands are used in a workflow, check out workflow examples.
Here are the currently supported commands:
- General admin commands
- WiFi Scanning/Sniffing
- WiFi Attacks
- WiFi Aux commands
Access CLI
The ESP32 Marauder firmware allows the user to interface with the device via its commandline interface over UART(TX, RX). If your device has a USB port, the physical connection is as simple as connecting the device to a PC or Android phone via USB cable. If your device does not have a USB port or your device is a Flipper Zero WiFi Dev Board, you will need to get a little more creative with how you interface with your device.
Note: To find out which serial port your device uses when plugged into your PC, use Device Manager
Standard USB
- Connect your Marauder device to a PC or Android phone
- Open your Serial terminal software
- If you are using a PC, make sure you have Putty installed
- If you are using an Android device, install a Serial terminal from the app store
- In your Serial terminal software, make sure the following is set
- Baud: 115200
- Port: Whatever serial port your device occupies when plugged in i.e.
COMX
- Click whatever button starts the connection
- Putty:
Open
- Android:
Figure it out I guess
- Putty:
- Verify the connection was successful by typing
help
and hitting enter- You should see a list of available commands show up
Flipper Zero WiFi Dev Board
- Connect your Dev Board to the Flipper Zero
- Plug your flipper zero into your PC or Android phone
- On your flipper, start the USB/UART bridge app under GPIO
- Make sure the following settings are set
- USB Channel: 0
- Baudrate: 115200
- Open your Serial terminal software
- If you are using a PC, make sure you have Putty installed
- If you are using an Android device, install a Serial terminal from the app store
- In your Serial terminal software, make sure the following is set
- Baud: 115200
- Port: Whatever serial port your device occupies when plugged in i.e.
COMX
- Click whatever button starts the connection
- Putty:
Open
- Android:
Figure it out I guess
- Putty:
- Verify the connection was successful by hitting the reset button on the dev board
- You should see the Marauder title screen appear
Access CLI
The ESP32 Marauder firmware allows the user to interface with the device via its commandline interface over UART(TX, RX). If your device has a USB port, the physical connection is as simple as connecting the device to a PC or Android phone via USB cable. If your device does not have a USB port or your device is a Flipper Zero WiFi Dev Board, you will need to get a little more creative with how you interface with your device.
Note: To find out which serial port your device uses when plugged into your PC, use Device Manager
Standard USB
- Connect your Marauder device to a PC or Android phone
- Open your Serial terminal software
- If you are using a PC, make sure you have Putty installed
- If you are using an Android device, install a Serial terminal from the app store
- In your Serial terminal software, make sure the following is set
- Baud: 115200
- Port: Whatever serial port your device occupies when plugged in i.e.
COMX
- Click whatever button starts the connection
- Putty:
Open
- Android:
Figure it out I guess
- Putty:
- Verify the connection was successful by typing
help
and hitting enter- You should see a list of available commands show up
Flipper Zero WiFi Dev Board
- Connect your Dev Board to the Flipper Zero
- Plug your flipper zero into your PC or Android phone
- On your flipper, start the USB/UART bridge app under GPIO
- Make sure the following settings are set
- USB Channel: 0
- Baudrate: 115200
- Open your Serial terminal software
- If you are using a PC, make sure you have Putty installed
- If you are using an Android device, install a Serial terminal from the app store
- In your Serial terminal software, make sure the following is set
- Baud: 115200
- Port: Whatever serial port your device occupies when plugged in i.e.
COMX
- Click whatever button starts the connection
- Putty:
Open
- Android:
Figure it out I guess
- Putty:
- Verify the connection was successful by hitting the reset button on the dev board
- You should see the Marauder title screen appear
SD Card Addon
If you happen to have a ESP32 board with the sd card addon I have found that sometimes the SD card will not work.
SD Cards that work that I have tested personally
SD Cards that DO NOT work
This one worked with the Flipper Zero Device but not in the ESP32 SD Card Addon with Marauder |