{"id":14963837,"url":"https://github.com/spacehuhn/esp8266_beaconspam","last_synced_at":"2025-04-09T07:06:07.448Z","repository":{"id":47616928,"uuid":"81657095","full_name":"spacehuhn/esp8266_beaconSpam","owner":"spacehuhn","description":"Creates up to a thousand WiFi access points with custom SSIDs.","archived":false,"fork":false,"pushed_at":"2024-08-08T19:55:26.000Z","size":1607,"stargazers_count":1079,"open_issues_count":26,"forks_count":207,"subscribers_count":57,"default_branch":"master","last_synced_at":"2025-04-09T07:06:00.401Z","etag":null,"topics":["attack","custom-ssids","esp8266","flood","spam","ssid","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/spacehuhn.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":"2017-02-11T14:11:43.000Z","updated_at":"2025-04-05T06:29:09.000Z","dependencies_parsed_at":"2024-01-05T20:59:16.404Z","dependency_job_id":"41b14191-dd92-4718-8c06-fc46388bbbb9","html_url":"https://github.com/spacehuhn/esp8266_beaconSpam","commit_stats":{"total_commits":36,"total_committers":5,"mean_commits":7.2,"dds":"0.33333333333333337","last_synced_commit":"672baecbba4c5f24339163359e063e897ba7bf4f"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacehuhn%2Fesp8266_beaconSpam","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacehuhn%2Fesp8266_beaconSpam/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacehuhn%2Fesp8266_beaconSpam/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spacehuhn%2Fesp8266_beaconSpam/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spacehuhn","download_url":"https://codeload.github.com/spacehuhn/esp8266_beaconSpam/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247994119,"owners_count":21030050,"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":["attack","custom-ssids","esp8266","flood","spam","ssid","wifi"],"created_at":"2024-09-24T13:32:12.858Z","updated_at":"2025-04-09T07:06:07.422Z","avatar_url":"https://github.com/spacehuhn.png","language":"C++","funding_links":["https://patreon.com/spacehuhn"],"categories":[],"sub_categories":[],"readme":"# ESP8266 Beacon Spam\n\n\n\u003cp align=\"center\"\u003e\u003cimg alt=\"project-logo\" width=\"300\" src=\"https://raw.githubusercontent.com/spacehuhn/esp8266_beaconSpam/master/img/beacon_spam.png\"\u003e\u003c/p\u003e\n \n\u003cp align=\"center\"\u003e\n🐦 \u003ca href=\"https://twitter.com/spacehuhn\"\u003eTwitter\u003c/a\u003e\n| 📺 \u003ca href=\"https://www.youtube.com/channel/UCFmjA6dnjv-phqrFACyI8tw\"\u003eYouTube\u003c/a\u003e\n| 🌍 \u003ca href=\"https://spacehuhn.de\"\u003espacehuhn.de\u003c/a\u003e\u003cbr/\u003e\n\u003cbr\u003e\np\u003cb\u003eAdvertise hundreds of WiFi access points with custom SSIDs.\u003cbr\u003e\n\u003cbr\u003e\nSupport the development of this project by purchasing one of the \u003ca href=\"https://github.com/spacehuhn/esp8266_deauther/wiki/Supported-Devices\"\u003eofficial deauther boards\u003c/a\u003e.\u003cbr/\u003eOr become a patron on \u003ca href=\"https://patreon.com/spacehuhn\" target=\"_blank\"\u003epatreon.com/spacehuhn\u003c/a\u003e.\u003c/b\u003e\n\u003c/p\u003e\n\nESP32 version by [@Tnze](https://github.com/Tnze): [esp32_beaconSpam](https://github.com/Tnze/esp32_beaconSpam).  \n\n## Changes\n\nI wrote the initial sketch in 2017 and it had some flaws.  \nHere are the latest changes (06/2018):  \n- Now works with ESP8266 Arduino Core v2.0.0 or newer without **any** further modification\n- Fixed the bug that the SSIDs are not shown correctly on IOS\n- No need for a SD card anymore to save hundrets of SSIDs, they are all stored in the PROGMEM now\n\nUsing the SD card might be useful for some people... but thanks to the magic of git, you can still view the old repository [here](https://github.com/spacehuhn/esp8266_beaconSpam/tree/v1.0). \n\nI didn't publish a .bin file on purpose. This project is easy to create with Arduino and everyone should be able to get it working!  \nThe goal of this is to motivate people to get into hacking, electronics and Arduino, so don't be lazy and start making your own stuff! :D\n\n## About\n\n![network scanner](https://raw.githubusercontent.com/spacehuhn/esp8266_beaconSpam/master/img/networkscanner.jpg)\n\nThis project emerged from the [ESP8266 Deauther](https://github.com/spacehuhn/esp8266_deauther) that also has this type of attack implemented.  \nBut while the Deauther is very complex and might seem intimidating to an Arduino beginner, this project is simple, hackable and easy get running!  \n\nThe Arduino sketch comes with 50 default SSID names, but you can edit that list easily in the source code :).  \nBy constantly broadcasting the so-called beacon frames, your standard WiFi scanner will think there are active networks nearby and adds them to the list.  \nIn reality though, it is just advertising these network names without actually creating them. So there is no way you could connect to one of the \"created\" networks.  \n\nIt is using the `wifi_send_pkt_freedom` function in the ESP8266 Arduino Core SDK. This function allows packet injection for specific Wi-Fi frames.  \n\n## Disclaimer\n\nEven if it is more of a fun party trick than something that could actually do any harm, **please use it respectfully!**\nSome people might interpret this as a \"Jammer\" and those are illegal. But this project is just sending a bunch of WiFi packets through the air and works within the 802.11 Wi-Fi standard.\n\n## Installation\n\n- First get an ESP8266 development board! If you don't know which one, have a look at the [supported devices](https://github.com/spacehuhn/esp8266_deauther/wiki/Supported-Devices) page from the Deauther wiki. It's for a different project, but the requirements are the same.\n- Install [Arduino](https://www.arduino.cc/en/Main/software)\n- Install the [ESP8266 Arduino Core](https://github.com/esp8266/Arduino#installing-with-boards-manager) version 2.0.0 or newer (no more changes are required)\n- Download [this project](https://github.com/spacehuhn/esp8266_beaconSpam/archive/master.zip)\n- Extract the .zip file somewhere and open the `esp8266_beaconSpam/esp8266_beaconSpam.ino` file with Arduino\n- Edit the SSIDs if you want\n- Select the correct Board under Tools \u003e Board, the serial (COM) port your device is using and hit upload!\n\nIf you have trouble uploading, have a look at the [installation guide](https://github.com/spacehuhn/esp8266_deauther/wiki/Installation#drivers-and-com-port) on the Deauther Wiki. There you will also find drivers for the most common USB-Serial chips.  \nAgain, this is for the Deauther and not for this project, but the hardware (ESP8266) is the same and you will find a lot of trouble-shooting info on the Wiki there! :)  \n\nAdditionally, here's a video tutorial :)  \n[![$5 WiFi Spammer](https://img.youtube.com/vi/Zq7QNpPxCqE/0.jpg)](https://www.youtube.com/watch?v=Zq7QNpPxCqE)\n\n## License\n\nThis project is licensed under the MIT License - see the [license file](LICENSE) file for details\n\n## Sources\n \nThe 50 default SSIDs are from: http://www.makeuseof.com/tag/50-funny-wi-fi-names-network-ssid/  \nMore info about beacon frames: https://mrncciew.com/2014/10/08/802-11-mgmt-beacon-frame/  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacehuhn%2Fesp8266_beaconspam","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspacehuhn%2Fesp8266_beaconspam","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspacehuhn%2Fesp8266_beaconspam/lists"}