Files

drjones 74236ef884 Remove vendor/reference dirs, add README

Made-with: Cursor

2026-03-17 20:08:56 -07:00

4.9 KiB

Raw Permalink Blame History

cute-handshake-capture

    ╔═══════════════════════════════════════════════════════════════╗
    ║  ▄▀▀▀▀▀▀▀▀▀▀▄  ▄▀▀▀▀▀▀▀▀▀▀▄  ▄▀▀▀▀▀▀▀▀▀▀▄  ▄▀▀▀▀▀▀▀▀▀▀▄  ║
    ║  █           █  █           █  █           █  █           █  ║
    ║  █  E A P O L █  █  4-WAY   █  █  HANDSHAKE █  █  CAPTURE  █  ║
    ║  █           █  █           █  █           █  █           █  ║
    ║  ▀▄▄▄▄▄▄▄▄▄▄▄▀  ▀▄▄▄▄▄▄▄▄▄▄▀  ▀▄▄▄▄▄▄▄▄▄▄▀  ▀▄▄▄▄▄▄▄▄▄▄▀  ║
    ╚═══════════════════════════════════════════════════════════════╝

Automatic WiFi 4-way handshake capture for Waveshare ESP32-C6 1.47" LCD.

▸ Overview

    ┌─────────────────────────────────────────────────────────────┐
    │  SCAN  ──►  DEAUTH  ──►  CAPTURE  ──►  SD CARD  ──►  RED   │
    │    │           │             │              │           │    │
    │    └───────────┴────────────┴──────────────┴───────────┘    │
    │                    continuous loop                           │
    └─────────────────────────────────────────────────────────────┘

Feature	Description
`SD_STORAGE`	PCAP files → TF card (not SPIFFS)
`DEAUTH_150ms`	Aggressive interval to force reauth
`GREEN→RED`	Display: uncaptured = green, captured = red
`WPA/WPA2`	Skips Open/WEP (no handshake to capture)
`BSSID_CACHE`	Captured networks stay red across rescans

▸ Hardware

Component	Spec
Board	Waveshare ESP32-C6-LCD-1.47 (non-touch, ST7789)
Display	172×320, 262K color
Storage	TF card slot (SPI)
RF	WiFi 6, 2.4 GHz

▸ Dependencies

Clone the Waveshare demo for LVGL and display drivers:

git clone https://github.com/waveshareteam/ESP32-C6-LCD-1.47-Demo.git

Or download from: https://www.waveshare.com/wiki/ESP32-C6-LCD-1.47

▸ Build

arduino-cli compile \
  -b 'esp32:esp32:esp32c6:PartitionScheme=huge_app' \
  --build-path /tmp/arduino-build-handshake-c6 \
  --libraries "ESP32-C6-LCD-1.47-Demo/Arduino/libraries" \
  handshake-capture-c6

▸ Flash

arduino-cli upload \
  -p /dev/cu.usbmodem* \
  -b 'esp32:esp32:esp32c6:PartitionScheme=huge_app' \
  --input-dir /tmp/arduino-build-handshake-c6

arduino-cli board list → find your port.

▸ Flow

    ┌──────────┐     ┌──────────────┐     ┌─────────────┐
    │  SCAN    │────►│  TARGET WPA   │────►│  SET CH     │
    │  networks│     │  (strongest)  │     │  DEAUTH     │
    └──────────┘     └──────────────┘     └──────┬──────┘
           ▲                                     │
           │                                     ▼
           │              ┌──────────────────────────────┐
           │              │  PROMISCUOUS RX              │
           │              │  beacon + EAPOL × 4          │
           │              └──────────────┬──────────────┘
           │                             │
           │                             ▼
           │              ┌──────────────────────────────┐
           └──────────────│  SAVE PCAP → SD              │
                          │  MARK RED → NEXT             │
                          └──────────────────────────────┘

▸ Output

PCAP files on TF card:

/handshake_SSID_timestamp.pcap

Compatible with hashcat, aircrack-ng, hcxpcapngtool.

▸ License

Use responsibly. Authorized testing only.

4.9 KiB Raw Permalink Blame History Unescape Escape