{"id":27775802,"url":"https://github.com/electro-gamma/esp32-handshake-capture","last_synced_at":"2026-05-17T17:43:32.333Z","repository":{"id":289927808,"uuid":"972844493","full_name":"Electro-Gamma/esp32-handshake-capture","owner":"Electro-Gamma","description":"A lightweight and portable tool designed for capturing WPA/WPA2 4-way handshakes using an ESP32 development board. Ideal for ethical penetration testing and wireless security research.","archived":false,"fork":false,"pushed_at":"2025-05-22T01:45:56.000Z","size":24,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-22T02:24:40.812Z","etag":null,"topics":["esp32","esp32-arduino","esp32-handshake-capture","ethical-tools","handshake","handshake-capture"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Electro-Gamma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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}},"created_at":"2025-04-25T19:00:29.000Z","updated_at":"2025-05-22T01:14:42.000Z","dependencies_parsed_at":"2025-04-25T20:23:39.361Z","dependency_job_id":"37ca34ef-0058-40af-9e69-6bbc203a19d6","html_url":"https://github.com/Electro-Gamma/esp32-handshake-capture","commit_stats":null,"previous_names":["electro-gamma/esp32-handshake-capture"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Electro-Gamma/esp32-handshake-capture","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electro-Gamma%2Fesp32-handshake-capture","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electro-Gamma%2Fesp32-handshake-capture/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electro-Gamma%2Fesp32-handshake-capture/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electro-Gamma%2Fesp32-handshake-capture/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Electro-Gamma","download_url":"https://codeload.github.com/Electro-Gamma/esp32-handshake-capture/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Electro-Gamma%2Fesp32-handshake-capture/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266592315,"owners_count":23953109,"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","status":"online","status_checked_at":"2025-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"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":["esp32","esp32-arduino","esp32-handshake-capture","ethical-tools","handshake","handshake-capture"],"created_at":"2025-04-30T04:57:15.981Z","updated_at":"2026-05-17T17:43:32.277Z","avatar_url":"https://github.com/Electro-Gamma.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WiFi Handshake Capture Tool\n\n\u003cdiv align=\"center\"\u003e\n  \n[![GPLv3 License](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE.md)\n[![Ethical Use](https://img.shields.io/badge/INTENDED_USE-Pentesting_Research-red)](https://github.com/Electro-Gamma/esp32-handshake-capture/blob/main/README.md#ethical-use)\n[![Platform](https://img.shields.io/badge/Platform-ESP32-important)](https://github.com/Electro-Gamma/esp32-handshake-capture/blob/main/README.md#requirements)\n[![Warning](https://img.shields.io/badge/WARNING-Legal_Restrictions-yellow)](https://github.com/Electro-Gamma/esp32-handshake-capture/blob/main/README.md#legal-disclaimer)\n\n\n\u003c/div\u003e\n\n## ⚠️ Legal Disclaimer\n\nThis software is provided strictly for educational and authorized testing purposes only.  \nUnauthorized use of this tool against networks you do not own or have written permission to test is illegal in most jurisdictions.  \nThe developers are not responsible for any misuse, damage, or legal consequences.\n\n---\n\n## Features\n\n- Captures WPA/WPA2 EAPOL 4-way handshakes\n- Saves captured data in PCAP format\n- Web interface to download handshakes\n- Portable and lightweight with ESP32\n- Passive monitoring (no injection required)\n- Works with tools like Wireshark, Aircrack-ng, Hashcat (after conversion)\n\n---\n\n## Requirements\n\n- ESP32 Development Board (e.g., DevKit v1)\n- USB cable (Micro-USB or USB-C depending on your board)\n- Arduino IDE or PlatformIO\n- Serial Monitor (115200 baud)\n- WiFi network you are authorized to test\n\n---\n\n## Flashing Instructions\n\n### Option 1: Arduino IDE\n\n1. Install ESP32 board support:\n   - File → Preferences → Additional Board URLs:\n     ```\n     https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json\n     ```\n2. Open Boards Manager and install \"ESP32\"\n3. Load `esp32-handshake-capture.ino`\n4. Select:\n   - Board: ESP32 Dev Module\n   - Port: Your correct COM/tty port\n5. Click \"Upload\"\n\n### Option 2: PlatformIO (VS Code)\n\n```bash\ngit clone https://github.com/Electro-Gamma/esp32-handshake-capture.git\ncd esp32-handshake-capture\npio run --target upload\n```\n\n---\n\n## Running the Tool\n\n1. Open a serial monitor at 115200 baud.\n2. The ESP32 will scan for nearby WiFi networks.\n3. Select the target network by its SSID/BSSID.\n4. The handshake is captured passively.\n5. ESP32 saves the handshake as a `.pcap` file.\n6. Connect to the ESP32's web interface to download the capture.\n\n---\n\n## Output\n\nCaptured handshakes are stored in `.pcap` format and compatible with:\n- Wireshark\n- aircrack-ng\n- hcxpcapngtool / hashcat\n\n---\n\n## Usage Policy\n\nThis tool is intended for:\n- Security researchers\n- Cybersecurity training labs\n- Authorized penetration testers\n- Educational demonstrations\n\nYou must:\n- Use only on networks you own or have explicit permission to test\n- Follow local, national, and international laws\n- Accept full responsibility for all usage\n\n---\n\n## Legal Notice\n\nBe aware of applicable laws that may govern or restrict the use of this tool, including but not limited to:\n- Computer Fraud and Abuse Act (CFAA)\n- General Data Protection Regulation (GDPR)\n- Digital Millennium Copyright Act (DMCA)\n- National and regional cybercrime laws\n\nThe authors are not liable for illegal or unethical use.\n\n---\n\n## License\n\nThis project is licensed under the **GNU General Public License v3.0 (GPLv3)**.  \nSee the [LICENSE](LICENSE.md) file for full terms.\n\n---\n\n## Contact\n\n- GitHub: [Electro-Gamma](https://github.com/Electro-Gamma)\n\n---\n\nStay ethical. Use responsibly.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectro-gamma%2Fesp32-handshake-capture","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felectro-gamma%2Fesp32-handshake-capture","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felectro-gamma%2Fesp32-handshake-capture/lists"}