Convert Figma logo to code with AI

spacehuhn logoesp8266_beaconSpam

Creates up to a thousand WiFi access points with custom SSIDs.

1,219
219
1,219
25
View on GitHub

Top Related Projects

martin-ger's avatar

esp_wifi_repeater

5,068

A full functional WiFi Repeater (correctly: a WiFi NAT Router)

Quick Overview

The esp8266_beaconSpam project is a tool for creating and broadcasting multiple WiFi beacon frames using the ESP8266 microcontroller. It allows users to generate a large number of fake WiFi networks, which can be used for various purposes such as testing, demonstration, or security research.

Pros

  • Easy to set up and use with ESP8266 hardware
  • Customizable beacon frame parameters
  • Can generate a large number of fake networks quickly
  • Open-source and actively maintained

Cons

  • Potential for misuse in disrupting legitimate WiFi networks
  • May be illegal in some jurisdictions if used improperly
  • Limited to ESP8266 hardware
  • Requires basic knowledge of WiFi protocols and ESP8266 programming

Code Examples

  1. Setting up the basic beacon spam:
#include "ESP8266WiFi.h"
#include "BeaconSpam.h"

void setup() {
  WiFi.mode(WIFI_OFF);
  wifi_set_opmode(STATION_MODE);
  
  BeaconSpam.setChannel(1);
  BeaconSpam.setSSID("Fake Network");
  BeaconSpam.start();
}

void loop() {
  BeaconSpam.update();
}
  1. Customizing beacon frame parameters:
BeaconSpam.setMAC(mac);
BeaconSpam.setHidden(true);
BeaconSpam.setWPA2(true);
  1. Creating multiple networks:
const char* ssids[] = {"Network1", "Network2", "Network3"};
int numNetworks = sizeof(ssids) / sizeof(ssids[0]);

for (int i = 0; i < numNetworks; i++) {
  BeaconSpam.setSSID(ssids[i]);
  BeaconSpam.start();
}

Getting Started

  1. Install the Arduino IDE and ESP8266 board support
  2. Clone the esp8266_beaconSpam repository
  3. Open the project in Arduino IDE
  4. Select your ESP8266 board and port
  5. Upload the sketch to your ESP8266
  6. Monitor the serial output for debugging information

Note: Ensure you comply with local laws and regulations when using this tool.

Competitor Comparisons

martin-ger logo

esp_wifi_repeater

5,068

A full functional WiFi Repeater (correctly: a WiFi NAT Router)

Pros of esp_wifi_repeater

  • Provides full Wi-Fi repeater functionality, extending network range
  • Supports NAT, allowing multiple devices to connect through a single IP
  • Offers more advanced networking features like DNS, DHCP, and TCP/UDP forwarding

Cons of esp_wifi_repeater

  • More complex setup and configuration compared to esp8266_beaconSpam
  • Requires more resources and may have higher power consumption
  • Less focused on specific Wi-Fi penetration testing tasks

Code Comparison

esp_wifi_repeater:

void ICACHE_FLASH_ATTR user_init(void) {
    uart_init(115200, 115200);
    os_printf("\r\n\r\nSDK version:%s\r\n", system_get_sdk_version());
    // ... (initialization code)
}

esp8266_beaconSpam:

void setup() {
  Serial.begin(115200);
  WiFi.mode(WIFI_OFF);
  wifi_set_opmode(STATION_MODE);
  // ... (setup code)
}

Both projects utilize the ESP8266 Wi-Fi capabilities, but esp_wifi_repeater focuses on creating a functional repeater, while esp8266_beaconSpam is designed for generating beacon frames. The code snippets show initialization differences, with esp_wifi_repeater using lower-level SDK functions and esp8266_beaconSpam using Arduino-style setup.

Convert Figma logo designs to code with AI

Visual Copilot

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

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/