This project uses an ESP8266 microcontroller to detect WiFi deauthentication (and disassociation) packets — often signs of an attempted WiFi attack. When an attack is detected, the system activates a buzzer, LED, and displays information on an OLED screen.
Live Demo: Click here to view live demo
- ** Channel Scanning**: Monitors specific WiFi channels for deauth and disassoc frames.
- ** Attack Detection**: Triggers alerts when a threshold of deauth packets is met.
- ** OLED Display**: Shows detection status and packet count.
- ** Audible Alerts**: Buzzer beeps when an attack is detected.
- ** LED Indicator**: LED lights up during attack.
This project is intended strictly for educational, defensive, and research purposes — to help users detect possible Wi‑Fi deauthentication/disassociation attacks and learn about wireless security. Do not use this code or hardware to perform attacks, interfere with other networks, or violate laws or terms of service. The author and contributors accept no responsibility or liability for any misuse, damages, loss of data, or legal consequences resulting from the use or modification of this project.
| Component | Description |
|---|---|
| ESP8266 | NodeMCU / Wemos D1 Mini |
| OLED Display | 128x64 I2C OLED (SSD1306) |
| Buzzer | Passive/active buzzer |
| LED | Any color |
| Resistor | 220Ω for LED (optional) |
| Wires | Male-to-male jumper wires |
| Breadboard | Optional for prototyping |
| TP4056 | Optional for Charging Board |
| 18650 Battery | Optional for PowerSupply |
Wiring Diagram
| Component | ESP8266 Pin |
|---|---|
| LED | LED_BUILTIN |
| Buzzer | D7 (GPIO13) |
| OLED VCC | 3.3V |
| OLED GND | GND |
| OLED SDA | D2 (GPIO4) |
| OLED SCL | D1 (GPIO5) |
Install the following libraries using Arduino IDE Library Manager or from the links below:
Special thanks to ❤ Spacehuhn for making this project possible!