https://github.com/roycuadra/wifi-jamming-detector
This project use a NodeMCU esp8266 It scans specific WiFi channels for deauth packets, When an attack is detected, it activates an LED and a buzzer while displaying relevant information on an OLED screen.
https://github.com/roycuadra/wifi-jamming-detector
buzzer esp12e esp8266 nodemcu oled-ssd1306
Last synced: about 2 months ago
JSON representation
This project use a NodeMCU esp8266 It scans specific WiFi channels for deauth packets, When an attack is detected, it activates an LED and a buzzer while displaying relevant information on an OLED screen.
- Host: GitHub
- URL: https://github.com/roycuadra/wifi-jamming-detector
- Owner: roycuadra
- License: mit
- Created: 2024-10-11T14:31:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-01-22T02:42:39.000Z (5 months ago)
- Last Synced: 2026-01-22T16:14:39.587Z (5 months ago)
- Topics: buzzer, esp12e, esp8266, nodemcu, oled-ssd1306
- Language: C++
- Homepage:
- Size: 584 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WiFi Jamming Detector
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](https://vt.tiktok.com/ZSrsUYohJ/)
---
## Features
- ** 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.
---
## Disclaimer
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.
---
## Hardware Requirements
| 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
**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) |
---
## Software Requirements
Install the following libraries using Arduino IDE Library Manager or from the links below:
- [Adafruit GFX Library](https://github.com/adafruit/Adafruit-GFX-Library)
- [Adafruit SSD1306 Library](https://github.com/adafruit/Adafruit_SSD1306)
- [ESP8266WiFi Library](https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WiFi)
---
## Thanks
Special thanks to ❤ **[Spacehuhn](https://github.com/SpacehuhnTech)** for making this project possible!