{"id":14963841,"url":"https://github.com/spacehuhntech/deauthdetector","last_synced_at":"2025-04-12T18:49:34.259Z","repository":{"id":43491634,"uuid":"88066841","full_name":"SpacehuhnTech/DeauthDetector","owner":"SpacehuhnTech","description":"Detect deauthentication frames using an ESP8266","archived":false,"fork":false,"pushed_at":"2023-08-28T12:56:53.000Z","size":1956,"stargazers_count":847,"open_issues_count":20,"forks_count":199,"subscribers_count":49,"default_branch":"master","last_synced_at":"2025-04-03T21:13:54.926Z","etag":null,"topics":["arduino","attack","deauth","deauthentication","detect","detector","disassociation","esp8266","exploit","prevention","wi-fi","wifi"],"latest_commit_sha":null,"homepage":null,"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/SpacehuhnTech.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}},"created_at":"2017-04-12T15:20:45.000Z","updated_at":"2025-04-02T13:35:53.000Z","dependencies_parsed_at":"2024-01-05T20:59:16.089Z","dependency_job_id":"2f9554bd-5d72-465e-b2df-d568dab585bd","html_url":"https://github.com/SpacehuhnTech/DeauthDetector","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpacehuhnTech%2FDeauthDetector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpacehuhnTech%2FDeauthDetector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpacehuhnTech%2FDeauthDetector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SpacehuhnTech%2FDeauthDetector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SpacehuhnTech","download_url":"https://codeload.github.com/SpacehuhnTech/DeauthDetector/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248618218,"owners_count":21134199,"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":["arduino","attack","deauth","deauthentication","detect","detector","disassociation","esp8266","exploit","prevention","wi-fi","wifi"],"created_at":"2024-09-24T13:32:13.230Z","updated_at":"2025-04-12T18:49:34.238Z","avatar_url":"https://github.com/SpacehuhnTech.png","language":"C++","readme":"# DeauthDetector\nDetect deauthentication frames using an ESP8266\n\n![esp8266 deauth detector custom build](https://raw.githubusercontent.com/spacehuhn/DeauthDetector/master/images/device.jpg)\n\n## Buy\n\n[Maltronics](https://maltronics.com/) is selling a Deauth Detector based on this project:  \n\n🛒 https://maltronics.com/products/deauth-detector\n\n## Support us\n\nHey, do you like this kind of project?  \n\nTo make sure we can keep working on free and open-source projects like this,  \n**please consider becoming a [:heart: Sponsor](https://github.com/sponsors/spacehuhntech) or support us via [:coffee: Ko-fi](https://ko-fi.com/spacehuhn).**  \n\nVisit [spacehuhn.com](https://spacehuhn.com) to learn more about us. :chicken:\n\n\u003ca href='https://ko-fi.com/G2G75FA4V' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://cdn.ko-fi.com/cdn/kofi2.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n## How it works  \n\nIf the ESP8266 detects [deauthentication or disassociation frames](https://mrncciew.com/2014/10/11/802-11-mgmt-deauth-disassociation-frames/) it will turn on its LED. That's all ¯\\ (ツ)/¯.  \n\n![blinky esp8266 deauth detector](https://raw.githubusercontent.com/spacehuhn/DeauthDetector/master/images/blink.jpg)\n\nSo this is a good and cheap way to detect a [Wi-Fi deauthentication attack](https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack).  \n\n## How to install it  \n\n**You will only need to follow one of the installation methods!**\n\n### Uploading the .bin file\n\nUpload the `deauth_detector.bin` using the [nodemcu-flasher](https://github.com/nodemcu/nodemcu-flasher) or the [esptool](https://github.com/espressif/esptool) from Espressif.\n\n### Using Arduino\n\n**1** Install [Arduino](https://www.arduino.cc/en/Main/Software)  \n**2** Install the [ESP8266 SDK](https://github.com/esp8266/Arduino)  \n**3** Download this project and open it with Arduino\n**4** Maybe customize the code:\n```\n#define channel 1 //the channel it should scan on (1-14)\n#define channelHopping true //scan on all channels\n#define maxChannel 13 //US = 11, EU = 13, Japan = 14\n#define ledPin 2 //led pin ( 2 = built-in LED)\n#define inverted true // invert HIGH/LOW for the LED\n#define packetRate 3 //min. packets before it gets recognized as an attack\n\n#define scanTime 500 //scan time per channel in ms\n```\n**5** Upload the code to your ESP8266 (don't forget to set it to the right upload settings!)\n\n**Done**\n","funding_links":["https://github.com/sponsors/spacehuhntech","https://ko-fi.com/spacehuhn).","https://ko-fi.com/G2G75FA4V'"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacehuhntech%2Fdeauthdetector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspacehuhntech%2Fdeauthdetector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacehuhntech%2Fdeauthdetector/lists"}