Universal, multi-display Wi-Fi Deauthentication Attack Detector powered by ESP32 & ESP8266.
DeauthDetectorUni is an advanced, hardware-agnostic security monitor designed to scan 2.4GHz Wi-Fi bands for disruptive management frames (Deauthentication and Disassociation packets). Unlike standard single-board detectors, this project features a modular architecture supporting multiple output methods—ranging from simple buzzers to high-resolution graphical screens.
Tip
Place code snippets or images here (e.g., docs/preview.gif) to instantly hook your visitors!
- 🛡️ Real-Time Detection: Continuously sniffs Wi-Fi channels to intercept malicious deauth frames within milliseconds.
- 📺 Universal Display Engine: Out-of-the-box support for:
- OLED Displays (SSD1306 via I2C)
- TFT Screens (ST7789/ILI9341 via SPI)
- E-Paper / E-Ink (For ultra-low power monitoring)
- RGB LEDs & Buzzers (For discreet peripheral alerts)
- ⚙️ Hardware Agnostic: Unified codebase designed to compile flawlessly across both legacy ESP8266 and high-performance ESP32 microcontrollers.
- 📊 Visual Diagnostics: Provides instant packet counters, RSSI tracking, and peak attack metrics on-screen.
| ESP32 Pin | Peripheral Pin | Description |
|---|---|---|
| GPIO 21 | SDA |
I2C Data Line |
| GPIO 22 | SCL |
I2C Clock Line |
| GPIO 4 | BUZZER |
Active/Passive Buzzer Alert |
| 3V3 | VCC |
Power Supply (3.3V) |
| GND | GND |
Ground |
This project is fully managed using PlatformIO inside VS Code. It completely removes the hassle of manual Arduino library management.
- Download and install VS Code.
- Install the PlatformIO IDE extension from the VS Code Marketplace.
-
Clone the Repository:
git clone https://github.com cd DeauthDetectorUni -
Select Your Target Environment: Open the project folder in VS Code. Locate the
platformio.inifile and set your active build target depending on your hardware:[platformio] default_envs = esp32_oled_env ; Modify based on your board config
-
Build & Flash:
- Click the PlatformIO: Build icon (Checkmark) at the bottom status bar.
- Click the PlatformIO: Upload icon (Right arrow) to flash your device.
Contributions, bug reports, and hardware profile submissions are highly encouraged! Feel free to:
- Fork the project.
- Create your feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes (
git commit -m 'Add some AmazingFeature'). - Push to the branch (
git push origin feature/AmazingFeature). - Open a Pull Request.
Distributed under the MIT License. See LICENSE for more information.
Developed with ☕ by HelDoRe