⚠️This repository is in public archive. Source codes does not provides deauthentication packet.⚠️

ESP32 wifi deauther with mini display

⚠️ Disclaimer ⚠️

This project is intended for educational and ethical purposes only. The use of deauthentication attacks may be illegal in your country or region. Please ensure that you have proper authorization before using this firmware to test any network.

Overview

esp32_wifi_deauther is a custom firmware for the ESP32 board that enables WiFi scanning, deauthentication attacks, and includes support for a 0.96-inch OLED display. The firmware is designed to leverage the powerful capabilities of the ESP32, making it a versatile tool for network analysis and testing. Schematics & PCB data is provided for the test.

Table of Contents

• Prerequisites & Setup
• Installation
• ESP32 wifi deauther PCB V3.0
• About This Project
• etc

Prerequisites & Setup

Required Libraries

• Adafruit SSD 1306 Library - Adafruit Github
• espressif arduino core for esp32 - Espressif Github

Required Library Setup

1. Open Arduino IDE
2. Install OLED libraries: Tools -> Manage Libraries -> search Adafruit SSD1306 -> install

3. Add esp32 additional board manager URL: Files -> Preferences -> add https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json to Additional Boards Manager URLs

4. Install esp32 board manager: Tools -> Board -> Boards Manager -> search esp32 -> install esp32 by Espressif Systems

Installation

1. Clone the repo or Download raw .zip file
2. open Arduino IDE
3. open esp_wifi_deauther.ino
4. upload to your device

ESP32 wifi deauther PCB V3.0

Components

Components	QTY	Price [KRW]	Total Price [KRW]
esp32 c3 super-mini	1	8,000	8,000
micro tact switch (NW3-A06-B3)	4	90	360
Chip LED 1608 RED (FC-DA1608HRK-620D)	1	40	40
SMD Multilayer Ceramic Capacitor, 0.1 µF (CEU4J2X7R1H104K125AE)	4	470	1,880
Adafruit 0.96 inch OLED	1	9,000	9,000
Ordered from Device-Mart

Downloads

You can download schematic & gerber files in here. You can order your own PCB on JLCPCB

Schematic Preview

PCB Preview

• 2D

• 3D

3D PCB model preview in here

About This Project

Key Features 🔑

• WiFi Scanning: Scans for available WiFi networks in the surrounding area and displays network details, such as SSID, signal strength, and channel information.
• Deauthentication Attacks: Provides the ability to perform deauthentication attacks on selected networks or clients, useful for network testing and penetration testing purposes.
• 0.96-inch OLED Display Support: Integrates a small OLED display for real-time data visualization, showing information about detected networks, attack status, and other metrics.
• Circuit Design: Features a simple circuit design that connects the ESP32 board to the OLED display, allowing for easy assembly and portability.

Hardware Requirements 💻

• ESP32 Board: A low-cost, low-power microcontroller with built-in WiFi and Bluetooth capabilities. (In this project, I used ESP32 C3 Super Mini )

• 0.96-inch OLED Display: A small, monochrome display module that provides visual output of network data and actions.
• Additional Components: Basic electronic components like resistors and wires for connecting the OLED display to the ESP32.

Use Cases 🪧

• Network Security Testing: Test the robustness and security of your WiFi networks.
• Educational Purposes: Learn about WiFi networks, how they operate, and common vulnerabilities.
• Network Analysis: Quickly scan and display information about nearby WiFi networks for analysis or troubleshooting.

Contributing

Feel free to submit issues, feature requests, and pull requests to improve the package.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contact

For any questions or feedback, please contact [email protected].