DOCSEARCHbyAlgolia
Submit Docs

ESP32 WiFi Hash Monster

repository·master·Indexed 22 days ago

https://github.com/g4lile0/esp32-wifi-hash-monster

An ESP32-based tool for M5STACK devices designed to capture EAPOL and PMKID WiFi handshake packets to an SD card for offline password cracking. Features include incognito mode, adjustable brightness, and multiple channel hopping modes (Auto-Channel and Smart-Channel). Compatible with ESP32 version 1.0.4 and M5stack-fire, with support for converting captured .pcap files to .hccapx for use with hashcat.

Tokens
572
Snippets
1
Records
4
Agent score
28%

What's inside esp32-wifi-hash-monster

  1. Overview of ESP32 WiFi Hash Monster

    master
    ESP32 WiFi Hash Monster is a tool designed for M5STACK / ESP32 devices that captures EAPOL and PMKID packets and stores them on an SD card. These captured packets can be used for offline dictionary or brute-force attacks to recover WPA2/PSK WiFi passwords. The device mimics some behaviors of the pwnagotchi project within an ESP32 SoC environment.

  2. Crack captured WiFi passwords using Hashcat

    master

    Once you have captured EAPOL/PMKID packets (stored as .pcap files on the SD card), you can crack them on a Linux (Ubuntu) machine using hashcat.

    1. Install Hashcat

    sudo apt-get update
sudo apt install hashcat

    2. Convert PCAP to HCCAPX

    hashcat requires the .hccapx format. Use cap2hccapx to convert your .pcap files:

    wget https://raw.githubusercontent.com/hashcat/hashcat-utils/master/src/cap2hccapx.c
gcc -o cap2hccapx cap2hccapx.c
./cap2hccapx 1.pcap 1.hccapx

    3. Run Brute Force Attack

    To run a brute force attack (e.g., for an 8-digit numeric password), use the following command:

    hashcat --force -m 2500 -a 3 -1 ?d -o cracked 1.hccapx ?1?1?1?1?1?1?1?1

    Note: Cracking long passwords without GPU acceleration or cloud assistance is extremely difficult.

  3. Control the ESP32 WiFi Hash Monster via Buttons

    master

    The device features three buttons with different short-press and long-press behaviors to manage capture modes, display settings, and channel hopping:

    Button 1: Mode & Storage

    • Short press: Toggles incognito mode (turns off Display and LEDs).
    • Long press: Enables the SD Card to start storing EAPOL/PMKID packets.

    Button 2: Brightness

    • Short press: Changes the display backlight brightness.
    • Long press: Changes the LED bars brightness.

    Button 3: WiFi Channels

    • Short press: Changes the current WiFi Channel.
    • Long press: Toggles between Auto-Channel and Smart-Channel modes.

    Channel Modes:

    • Auto-Channel: Hops between channels 1 and 6 every 15 seconds.
    • Smart-Channel: Covers all channels sequentially. It only hops if no new SSID, EAPOL, or DEAUTH packets are detected within 15 seconds.