https://github.com/mjlee111/esp32_wifi_deauther
A simple ESP32 based wifi hacking tool. Supports mini oled display & test circuit available.
https://github.com/mjlee111/esp32_wifi_deauther
deauth deauthentication-attack esp-wifi-deauth esp32 wifi-hacking
Last synced: 4 months ago
JSON representation
A simple ESP32 based wifi hacking tool. Supports mini oled display & test circuit available.
- Host: GitHub
- URL: https://github.com/mjlee111/esp32_wifi_deauther
- Owner: mjlee111
- License: mit
- Archived: true
- Created: 2024-09-08T10:34:17.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-11-05T08:20:01.000Z (7 months ago)
- Last Synced: 2025-01-22T09:27:51.102Z (5 months ago)
- Topics: deauth, deauthentication-attack, esp-wifi-deauth, esp32, wifi-hacking
- Language: C++
- Homepage:
- Size: 5.47 MB
- Stars: 11
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**⚠️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](#prerequisites--setup)
- [Installation](#installation)
- [ESP32 wifi deauther PCB V3.0](#esp32-wifi-deauther-pcb-v30)
- [About This Project](#about-this-project)
- [etc](#contributing)
## Prerequisites & Setup
### Required Libraries
- Adafruit SSD 1306 Library - [Adafruit Github][oled-link]
- espressif arduino core for esp32 - [Espressif Github][espressif-link]
### 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][device-mart]
### Downloads
You can download `schematic` & `gerber` files in [here][circuit-download].
You can order your own PCB on [JLCPCB][JLC]
### Schematic Preview
### PCB Preview
- 2D
- 3D
3D PCB model preview in [here][model-link]
## 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][esp32-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][LICENSE] file for details.
## Contact
For any questions or feedback, please contact [[email protected]][email].
[esp32-super-mini]: https://www.sudo.is/docs/esphome/boards/esp32c3supermini/
[oled-link]: https://github.com/adafruit/Adafruit_SSD1306.git
[espressif-link]: https://github.com/espressif/arduino-esp32.git
[circuit-download]: https://drive.google.com/drive/folders/1x_XnUtAgamwl68b8rXIz4eCWMjAYlUFH?usp=sharing
[device-mart]: https://www.devicemart.co.kr/main/index
[JLC]: https://jlcpcb.com/
[model-link]: https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/PCB/3D_model_preview.md
[LICENSE]: https://github.com/mjlee111/esp32_wifi_deauther/blob/master/LICENSE
[email]: mailto:[email protected]