Sometimes you just gotta do what you gotta do. Am I right, ladies? The ESP32 Marauder is a suite of WiFi/Bluetooth offensive and defensive tools created for the ESP32 and was originally inspired by Spacehuhn's esp8266_deauther project. The tool itself serves as a portable device used to test and analyze WiFi and Bluetooth devices. Use this tool and its firmware with caution as the use of some of its capabilities without explicit consent from the target owner is unlawful in most countries. For more information about this project and how it's assembled, follow the video link below.
Note: Because of espressif's ESP32-IDF, the ESP32 included with Marauder is incapable of transmitting deauthentication frames.

YouTube

Hackster Article

You can check out the marauder article written here as well as other interesting engineering projects.

Capabilities

Current

Probe Request Sniff: Sniff for WiFi probe request frames sent by wireless devices
Beacon Sniff: Sniff beacon frames sent by wireless acccess points
Beacon Spam Random: Spam hundreds of random beacon frames to wireless devices within range
Rick Roll Beacon: Broadcast the rick roll lyrics as WiFi access points
Bluetooth Sniffer: Sniff bluetooth devices within range
Detect Card Skimmers: Detect bluetooth enabled credit card skimmers
Packet Monitor: Show WiFi packet density on a given channel using a time bar graph
Deauthentication Packet Sniffer: Detect deauthentication packets sent on all channels
Draw: Just doodle on the screen or whatever

Developing

Emulate Bluetooth: Emulate a bluetooth device with a specific name
OTA Firmware Update: Update Marauder firmware over the air with .bin file

Do It Yourself

Hardware

This project requires the following hardware in order to work:

Any ESP32 Development Board
2.8" TFT Touch Screen w/ ili9341
Jumper Wires
Breadboard

Connections

Make the following connections between your 2.8" TFT Screen and your ESP32 board. You may need to refer to a pinout sheet specific to the ESP32 dev board you have chosen. For more infomation about this circuit, please refer to this schematic

2.8" TFT	ESP32
VCC	VCC
GND	GND
CS	GPIO17
RESET	GPIO5
D/C	GPIO16
MOSI	GPIO23
SCK	GPIO18
LED	GPIO32
MISO	GPIO19
T_CLK	GPIO18
T_CS	GPIO21
T_DI	GPIO23
T_DO	GPIO19
T_IRQ	N/C

Flashing Firmware

Using Arduino IDE

Install the Arduino IDE
In the Arduino IDE, go to File>Preferences
Add the following URL to Additional Boards Manager URLs:
- https://dl.espressif.com/dl/package_esp32_index.json
Go to Tools>Board>Boards Manager, search for esp32 and install esp32 by Espressif Systems
Install Spacehuhn's SimpleList library in your Arduino IDE
- Download the SimpleList repo
- In the Arduino IDE, go to Sketch>Include Library>Add .ZIP Library... and add the SimpleList-master.zip you just downloaded
Install Bodmer's TFT_eSPI library in your Arduino IDE
- Download the TFT_eSPI repo
- In the Arduino IDE, go to Sketch>Include Library>Add .ZIP Library... and add the TFT-eSPI-master.zip you just downloaded
- Make the following modifications shown in this issue to the TFT_eSPI library you just installed
Follow these instructions for installing ESP32 Spiffs Tool
Install the CH340 Drivers
Download or clone this repository
Open esp32_marauder.ino
Plug your ESP32 into a USB port and select the COM port under Tools>Port
Select LOLIN D32 under Tools>Boards
Click ESP32 Sketch Data Upload and wait for the SPIFFS upload to finish
Click the upload button

Under Development

Currently the ESP32 Marauder has limited firmware capabilities. Most of the work so far has been put into designing the hardware. New firmware features will be added over time and will eventually reach a point where this project will be a fully capable hacking machine.

Special Thanks

Spacehuhn for an easy to use linked list library SimpleList
- Also a well designed menu structure. I adapted it to the TFT GUI because it worked perfectly
Bodmer for a comprehensive TFT touch screen library TFT_eSPI
HyderHasnain for an adaptable line graph to be used as the packet monitor

For Sale Now

You can buy the ESP32 Marauder using this link

Languages

C++ 70.4%

C 28.8%

Python 0.5%

XSLT 0.2%

HTML 0.1%