Skip to content

Latest commit

 

History

History
72 lines (49 loc) · 4.68 KB

README.md

File metadata and controls

72 lines (49 loc) · 4.68 KB

ESP8266 Beacon Spam

project-logo

🐦 Twitter | 📺 YouTube | 🌍 spacehuhn.de

pAdvertise hundreds of WiFi access points with custom SSIDs.

Support the development of this project by purchasing one of the official deauther boards.
Or become a patron on patreon.com/spacehuhn.

ESP32 version by @Tnze: esp32_beaconSpam.

Changes

I wrote the initial sketch in 2017 and it had some flaws.
Here are the latest changes (06/2018):

  • Now works with ESP8266 Arduino Core v2.0.0 or newer without any further modification
  • Fixed the bug that the SSIDs are not shown correctly on IOS
  • No need for a SD card anymore to save hundrets of SSIDs, they are all stored in the PROGMEM now

Using the SD card might be useful for some people... but thanks to the magic of git, you can still view the old repository here.

I 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!
The 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

About

network scanner

This project emerged from the ESP8266 Deauther that also has this type of attack implemented.
But while the Deauther is very complex and might seem intimidating to an Arduino beginner, this project is simple, hackable and easy get running!

The Arduino sketch comes with 50 default SSID names, but you can edit that list easily in the source code :).
By constantly broadcasting the so-called beacon frames, your standard WiFi scanner will think there are active networks nearby and adds them to the list.
In 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.

It is using the wifi_send_pkt_freedom function in the ESP8266 Arduino Core SDK. This function allows packet injection for specific Wi-Fi frames.

Disclaimer

Even if it is more of a fun party trick than something that could actually do any harm, please use it respectfully! Some 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.

Installation

  • First get an ESP8266 development board! If you don't know which one, have a look at the supported devices page from the Deauther wiki. It's for a different project, but the requirements are the same.
  • Install Arduino
  • Install the ESP8266 Arduino Core version 2.0.0 or newer (no more changes are required)
  • Download this project
  • Extract the .zip file somewhere and open the esp8266_beaconSpam/esp8266_beaconSpam.ino file with Arduino
  • Edit the SSIDs if you want
  • Select the correct Board under Tools > Board, the serial (COM) port your device is using and hit upload!

If you have trouble uploading, have a look at the installation guide on the Deauther Wiki. There you will also find drivers for the most common USB-Serial chips.
Again, 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! :)

Additionally, here's a video tutorial :)
$5 WiFi Spammer

License

This project is licensed under the MIT License - see the license file file for details

Sources

The 50 default SSIDs are from: http://www.makeuseof.com/tag/50-funny-wi-fi-names-network-ssid/
More info about beacon frames: https://mrncciew.com/2014/10/08/802-11-mgmt-beacon-frame/