{"id":28181484,"url":"https://github.com/roycuadra/wifi-jamming-detector","last_synced_at":"2026-04-30T19:32:24.839Z","repository":{"id":288923352,"uuid":"871233944","full_name":"roycuadra/WiFi-Jamming-Detector","owner":"roycuadra","description":"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.","archived":false,"fork":false,"pushed_at":"2026-01-22T02:42:39.000Z","size":598,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-22T16:14:39.587Z","etag":null,"topics":["buzzer","esp12e","esp8266","nodemcu","oled-ssd1306"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roycuadra.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-10-11T14:31:41.000Z","updated_at":"2026-01-22T02:42:56.000Z","dependencies_parsed_at":"2025-04-20T13:43:32.440Z","dependency_job_id":"1cbfceab-c111-4985-9d71-bc29f116b237","html_url":"https://github.com/roycuadra/WiFi-Jamming-Detector","commit_stats":null,"previous_names":["roycuadra/wifi-deauth-detector-oled"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/roycuadra/WiFi-Jamming-Detector","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roycuadra%2FWiFi-Jamming-Detector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roycuadra%2FWiFi-Jamming-Detector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roycuadra%2FWiFi-Jamming-Detector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roycuadra%2FWiFi-Jamming-Detector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roycuadra","download_url":"https://codeload.github.com/roycuadra/WiFi-Jamming-Detector/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roycuadra%2FWiFi-Jamming-Detector/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32475192,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"ssl_error","status_checked_at":"2026-04-30T13:12:06.837Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["buzzer","esp12e","esp8266","nodemcu","oled-ssd1306"],"created_at":"2025-05-16T03:13:02.289Z","updated_at":"2026-04-30T19:32:24.834Z","avatar_url":"https://github.com/roycuadra.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WiFi Jamming Detector\n\nThis 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**.\n\n[ **Live Demo**: Click here to view live demo](https://vt.tiktok.com/ZSrsUYohJ/)\n\n---\n\n## Features\n\n-  ** Channel Scanning**: Monitors specific WiFi channels for deauth and disassoc frames.\n-  ** Attack Detection**: Triggers alerts when a threshold of deauth packets is met.\n-  ** OLED Display**: Shows detection status and packet count.\n-  ** Audible Alerts**: Buzzer beeps when an attack is detected.\n-  ** LED Indicator**: LED lights up during attack.\n\n---\n\n## Disclaimer\n\nThis 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.\n\n---\n\n## Hardware Requirements\n\n| Component    | Description                        |\n|--------------|------------------------------------|\n| ESP8266      | NodeMCU / Wemos D1 Mini            |\n| OLED Display | 128x64 I2C OLED (SSD1306)          |\n| Buzzer       | Passive/active buzzer              |\n| LED          | Any color                          |\n| Resistor     | 220Ω for LED (optional)            |\n| Wires        | Male-to-male jumper wires          |\n| Breadboard   | Optional for prototyping           |\n| TP4056       | Optional for Charging Board        |\n| 18650 Battery| Optional for PowerSupply           |\n\n---\n\n## Wiring Diagram\n\n**Wiring Diagram**  \n![Wiring Diagram](image/image_1.png)\n\n\n| Component       | ESP8266 Pin |\n|------------------|-------------|\n| **LED**          | LED_BUILTIN |\n| **Buzzer**       | D7 (GPIO13) |\n| **OLED VCC**     | 3.3V        |\n| **OLED GND**     | GND         |\n| **OLED SDA**     | D2 (GPIO4)  |\n| **OLED SCL**     | D1 (GPIO5)  |\n\n---\n\n## Software Requirements\n\nInstall the following libraries using Arduino IDE Library Manager or from the links below:\n\n-  [Adafruit GFX Library](https://github.com/adafruit/Adafruit-GFX-Library)  \n-  [Adafruit SSD1306 Library](https://github.com/adafruit/Adafruit_SSD1306)  \n-  [ESP8266WiFi Library](https://github.com/esp8266/Arduino/tree/master/libraries/ESP8266WiFi)\n\n---\n\n## Thanks\n\nSpecial thanks to ❤ **[Spacehuhn](https://github.com/SpacehuhnTech)** for making this project possible!\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froycuadra%2Fwifi-jamming-detector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froycuadra%2Fwifi-jamming-detector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froycuadra%2Fwifi-jamming-detector/lists"}