{"id":15064102,"url":"https://github.com/mjlee111/esp32_wifi_deauther","last_synced_at":"2025-10-31T22:30:20.316Z","repository":{"id":256004826,"uuid":"854071225","full_name":"mjlee111/esp32_wifi_deauther","owner":"mjlee111","description":"A simple ESP32 based wifi hacking tool. Supports mini oled display \u0026 test circuit available.","archived":true,"fork":false,"pushed_at":"2024-11-05T08:20:01.000Z","size":5733,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-22T09:27:51.102Z","etag":null,"topics":["deauth","deauthentication-attack","esp-wifi-deauth","esp32","wifi-hacking"],"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/mjlee111.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}},"created_at":"2024-09-08T10:34:17.000Z","updated_at":"2025-01-20T10:56:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"f237a0fd-2055-4124-a0ab-a07cc20010e9","html_url":"https://github.com/mjlee111/esp32_wifi_deauther","commit_stats":{"total_commits":28,"total_committers":2,"mean_commits":14.0,"dds":0.0357142857142857,"last_synced_commit":"5121b7f555ba0315b57a47ea40f0f19dc16475b3"},"previous_names":["mjlee111/esp32_wifi_deauther"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjlee111%2Fesp32_wifi_deauther","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjlee111%2Fesp32_wifi_deauther/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjlee111%2Fesp32_wifi_deauther/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mjlee111%2Fesp32_wifi_deauther/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mjlee111","download_url":"https://codeload.github.com/mjlee111/esp32_wifi_deauther/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239236414,"owners_count":19604902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["deauth","deauthentication-attack","esp-wifi-deauth","esp32","wifi-hacking"],"created_at":"2024-09-25T00:11:30.003Z","updated_at":"2025-10-31T22:30:20.224Z","avatar_url":"https://github.com/mjlee111.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"**⚠️This repository is in public archive. Source codes does not provides deauthentication packet.⚠️**\n\n# ESP32 wifi deauther with mini display\n\u003cimg src=\"https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/logo.png\" alt=\"logo\" width=\"200\" height=\"200\"\u003e\u003cimg src=\"https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/v1.jpg\" alt=\"v1\" height=\"200\"\u003e\n\n## ⚠️ Disclaimer ⚠️\n\n**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.**\n\n## Overview\n`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 \u0026 PCB data is provided for the test.\n\n\u003cimg src=\"https://img.shields.io/badge/C-A8B9CC?style=flat\u0026logo=c\u0026logoColor=white\"/\u003e \u003cimg src=\"https://img.shields.io/badge/C++-00599C?style=flat\u0026logo=cplusplus\u0026logoColor=white\"/\u003e \n\u003cimg src=\"https://img.shields.io/badge/Altium Designer-A5915F?\u0026style=flat\u0026logo=Altium Designer\u0026logoColor=white\"/\u003e \n\u003cimg src=\"https://img.shields.io/badge/ESP32-E7352C?\u0026style=flat\u0026logo=Espressif\u0026logoColor=white\"/\u003e \n\n\n## Table of Contents\n- [Prerequisites \u0026 Setup](#prerequisites--setup)\n- [Installation](#installation)\n- [ESP32 wifi deauther PCB V3.0](#esp32-wifi-deauther-pcb-v30)\n- [About This Project](#about-this-project)\n- [etc](#contributing)\n\n## Prerequisites \u0026 Setup\n### Required Libraries\n- Adafruit SSD 1306 Library - [Adafruit Github][oled-link]\n- espressif arduino core for esp32 - [Espressif Github][espressif-link] \n\n### Required Library Setup\n1. Open `Arduino IDE`\n2. Install OLED libraries: `Tools` -\u003e `Manage Libraries` -\u003e search `Adafruit SSD1306` -\u003e install\n\n\u003cimg src=\"https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/installation/adafruit-library-installation.png\" alt=\"fig1\"\u003e\n\n3. Add `esp32 additional board manager URL`: `Files` -\u003e `Preferences` -\u003e add `https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_dev_index.json` to `Additional Boards Manager URLs`\n\n\u003cimg src=\"https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/installation/preferences.png\" alt=\"fig2\"\u003e\n\n4. Install `esp32 board manager`: `Tools` -\u003e `Board` -\u003e `Boards Manager` -\u003e search `esp32` -\u003e install `esp32 by Espressif Systems`\n\n\u003cimg src=\"https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/installation/esp32-board-manager-installation.png\" alt=\"fig3\"\u003e\n\n## Installation\n1. Clone the repo or Download raw .zip file\n2. open `Arduino IDE`\n3. open `esp_wifi_deauther.ino`\n4. upload to your device\n\n## ESP32 wifi deauther PCB V3.0\n### Components\n| Components                                      | QTY | Price [KRW] | Total Price [KRW] |\n|-------------------------------------------------|-----|-------------|-------------------|\n| esp32 c3 super-mini                              | 1   | 8,000       | 8,000             |\n| micro tact switch (NW3-A06-B3)                   | 4   | 90          | 360               |\n| Chip LED 1608 RED (FC-DA1608HRK-620D)            | 1   | 40          | 40                |\n| SMD Multilayer Ceramic Capacitor, 0.1 µF (CEU4J2X7R1H104K125AE) | 4   | 470         | 1,880             |\n| Adafruit 0.96 inch OLED                          | 1   | 9,000       | 9,000             |\nOrdered from [Device-Mart][device-mart]\n\n### Downloads\nYou can download `schematic` \u0026 `gerber` files in [here][circuit-download].\nYou can order your own PCB on [JLCPCB][JLC]\n\n### Schematic Preview\n\u003cimg src=\"https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/PCB/schematic.png\" alt=\"schematic\"\u003e\n\n### PCB Preview\n- 2D\n\n\u003cimg src=\"https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/PCB/pcb_2d.png\" alt=\"pcb_2d\"\u003e\n\n- 3D\n\n3D PCB model preview in [here][model-link]\n\n## About This Project\n### Key Features 🔑\n\n- **WiFi Scanning:** Scans for available WiFi networks in the surrounding area and displays network details, such as SSID, signal strength, and channel information.\n- **Deauthentication Attacks:** Provides the ability to perform deauthentication attacks on selected networks or clients, useful for network testing and penetration testing purposes.\n- **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.\n- **Circuit Design:** Features a simple circuit design that connects the ESP32 board to the OLED display, allowing for easy assembly and portability.\n\n### Hardware Requirements 💻\n\n- **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] )\n\u003cimg src=\"https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/esp32_c3_super_mini.jpg\" alt=\"esp32_super_mini\"\u003e\n\n- **0.96-inch OLED Display:** A small, monochrome display module that provides visual output of network data and actions.\n- **Additional Components:** Basic electronic components like resistors and wires for connecting the OLED display to the ESP32.\n\n### Use Cases 🪧\n\n- **Network Security Testing:** Test the robustness and security of your WiFi networks.\n- **Educational Purposes:** Learn about WiFi networks, how they operate, and common vulnerabilities.\n- **Network Analysis:** Quickly scan and display information about nearby WiFi networks for analysis or troubleshooting.\n\n## Contributing\nFeel free to submit issues, feature requests, and pull requests to improve the package.\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE][LICENSE] file for details.\n\n## Contact\nFor any questions or feedback, please contact [menggu1234@naver.com][email].\n\n[esp32-super-mini]: https://www.sudo.is/docs/esphome/boards/esp32c3supermini/\n[oled-link]: https://github.com/adafruit/Adafruit_SSD1306.git\n[espressif-link]: https://github.com/espressif/arduino-esp32.git\n[circuit-download]: https://drive.google.com/drive/folders/1x_XnUtAgamwl68b8rXIz4eCWMjAYlUFH?usp=sharing\n[device-mart]: https://www.devicemart.co.kr/main/index\n[JLC]: https://jlcpcb.com/\n[model-link]: https://github.com/mjlee111/esp32_wifi_deauther/blob/master/docs/PCB/3D_model_preview.md\n[LICENSE]: https://github.com/mjlee111/esp32_wifi_deauther/blob/master/LICENSE\n[email]: mailto:menggu1234@naver.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmjlee111%2Fesp32_wifi_deauther","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmjlee111%2Fesp32_wifi_deauther","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmjlee111%2Fesp32_wifi_deauther/lists"}