ESP32 Marauder

A fork for the ESP32-S3-Mini dev board (16MB flash, 8MB PSRAM on external IC's)

Development Plan

Current Status

• Fixed: EAPOL/PMKID scan logging now works correctly with GPS coordinates
• Fixed: Resolved double extension issue in file naming (e.g., .pcap.cap → .pcap)
• Improved: Unified log format across all scan modes to match wardrive format
• Enhanced: Better error handling for SD card operations

Task List

• Review and compare file system (SD/SPIFFS/FFat) initialization in Wardrive vs. EAPOL/PMKID Scan modes
• Identify where file system mounting is missing or fails in EAPOL/PMKID Scan
• Implement conditional SD object selection in EAPOL/PMKID scan logging
• Unify EAPOL/PMKID scan log format with executeWarDrive/RunProbeScan
• Fix double extension for .pcap and .log files
• Test EAPOL/PMKID Scan logging after applying fix
• Update all scan modes to use new getTimestampedFilename signature and fix related compilation errors
• Verify Buffer class double extension fix in all scan modes

Current Goal

Test all scan modes for correct log output and file creation

Notes

• Wardrive mode successfully creates and writes to the log file (wardrive_[timestamp].log).
• EAPOL/PMKID Scan now correctly creates log files (eapolwardrive_[timestamp].log).
• Unified log format across all scan modes for consistency.
• Fixed file system mounting issues for ESP32-S3 Mini.
• Resolved double extension issues in file naming.

EAPOL Wardriving Feature

Overview

EAPOL Wardriving allows capturing WPA handshakes while moving, with GPS coordinates logged for each capture. This is particularly useful for penetration testing and security assessments of wireless networks.

Recent Fixes & Improvements

1. Fixed File System Mounting

   • Corrected SD card initialization for ESP32-S3 Mini
   • Added proper error handling for file operations

2. Unified Log Format

   • Standardized log format to match wardrive/probe scan formats
   • Added GPS coordinates, timestamps, and signal strength to logs

3. File Naming

   • Fixed double extension issue (e.g., eapol_wardrive_2025-07-05_13-37-04.log)
   • Added proper timestamp-based naming

4. Compatibility

   • Works with both FFAT and standard file systems
   • Supports both SD and SD_MMC interfaces

Usage

1. Enable GPS module
2. Insert SD card
3. Start EAPOL scan from the menu
4. Logs will be saved to the SD card with timestamps and GPS data

EAPOL Wardriving Feature

Overview

EAPOL Wardriving allows capturing WPA handshakes while moving, with GPS coordinates logged for each capture. This is particularly useful for penetration testing and security assessments of wireless networks.

Recent Fixes & Improvements

1. Fixed File System Mounting

   • Corrected SD card initialization for ESP32-S3 Mini
   • Added proper error handling for file operations

2. Unified Log Format

   • Standardized log format to match wardrive/probe scan formats
   • Added GPS coordinates, timestamps, and signal strength to logs

3. File Naming

   • Fixed double extension issue (e.g., eapol_wardrive_2025-07-05_13-37-04.log)
   • Added proper timestamp-based naming

4. Compatibility

   • Works with both FFAT and standard file systems
   • Supports both SD and SD_MMC interfaces

Usage

1. Enable GPS module
2. Insert SD card
3. Start EAPOL scan from the menu
4. Logs will be saved to the SD card with timestamps and GPS data
   
   

A suite of WiFi/Bluetooth offensive and defensive tools for the ESP32

Getting Started

Download the latest release of the firmware.

Check out the project wiki for a full overview of the ESP32 Marauder

For Sale Now

You can buy the ESP32 Marauder using this link