Remove vendor/reference dirs, add README

Made-with: Cursor
2026-03-17 20:08:56 -07:00
parent 026f15a4a7
commit 74236ef884
2991 changed files with 127 additions and 820175 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,123 @@
+# 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
+
+```bash
+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
+
+```bash
+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.