Wraith - ESP8266 WiFi Pentest Tool

Functional Capabilities

Physical Interface (OLED & Buttons)

• Scanning:
  • Access Points: Scans for 802.11 b/g/n networks.
  • Stations: Identifies connected client devices.
• Attacks:
  • Deauthentication: Sends deauth frames to disconnect targets.
  • Beacon Flooding: Broadcasts multiple fake SSIDs.
  • Probe Request: Sends probe frames to identify hidden networks.
• Monitoring:
  • Packet Monitor: Displays traffic density on a selected channel.
  • RSSI Tracking: Monitors signal strength for a specific MAC address.
• Other:
  • Captive Portal: Hosts a web server for phishing simulations.

Web Dashboard

• Remote Control: Mirrors the OLED screen and provides button input via WebSocket.
• Management: Configuration and control of scans and attacks.
• Telemetry: Displays system uptime, memory status, and packet rates.

---

Hardware Configuration

Components

• MCU: ESP8266 (NodeMCU, Wemos D1 Mini, or ESP-12).
• Display: I2C OLED (128x64).
• Driver Support: SSD1306 (0.96") and SH1106 (1.3").
• Input: 4-button navigation system.

Default Pinout (NodeMCU)

Component	Pin	GPIO
OLED SDA	D2	4
OLED SCL	D1	5
Button UP	D5	14
Button DOWN	D6	12
Button A	D4	2
Button B	D3	0

Configuration can be modified in src/A_config.h.

---

CLI Reference

Connect via Serial at 115200 baud.

Command	Description
scan ap	Scan for Access Points
show ap	List scan results
attack -d	Start deauth attack
set ssid <name>	Configure SSID for beaconing
sysinfo	Show system status
help	List all commands

---

Installation

1. Install PlatformIO.
2. Upload Filesystem:

   pio run --target uploadfs

3. Upload Firmware:

   pio run --target upload

---

[!CAUTION] This tool is for educational and authorized testing only. Unauthorized use on networks without permission is illegal.