m13253 / wifijam

An 802.11n beacon frame transmission program

wifijam ‒ An 802.11n beacon frame transmission program

Wifijam is a program that sends 802.11n beacon frames to announce fake Wi-Fi access points. These fake access points will have passwords and can not be really connected to.

This program comes with two versions: a Scapy version and an ESP8266 version.

The Scapy version requires a Linux computer with a Wi-Fi card supporting the "monitor" mode, as well as Python 3 and scapy-python3.

The ESP8266 version requires a development board with an ESP8266 Wi-Fi chip (usually less than $9), along with the Arduino IDE with ESP8266 plugins.

Usage

Before you start

Edit the source code, modify ssid_list for a list of SSIDs you wish to send.

Then modify SSID_DUPLICATES for the number of duplicates for each SSID.

SSID_DUPLICATES must be no more than 10. SSID_DUPLICATES × the length of ssid_list should be no more than 80.

Scapy version (using iw)

Type:

sudo ip link set dev wlan0 down
sudo iw dev wlan0 interface add wlan0mon type monitor
sudo ./wifijam.py wlan0mon

… where wlan0 is the device name of your Wi-Fi card. Change them according to your situation.

After you finished, type:

sudo iw dev wlan0mon del
sudo ip link set dev wlan0 up

Scapy version (using aircrack-ng)

Alternatively, if iw does not work for you, try airmon-ng:

sudo airmon-ng start wlan0
sudo ./wifijam.py wlan0mon

… where wlan0 is the device name of your Wi-Fi card, wlan0mon is the monitor name given by airmon-ng. Change them according to your situation.

After you finished, type:

sudo airmon-ng stop wlan0mon

ESP8266 version

Connect your development board to the Arduino IDE. Open wifijam.ino, then click Sketch → Upload.

You might need to press the "Flash" button if your development board has one.

Refer to the ESP8266 documentation if you have any problems.

Warning

The program's authors release this program in the hope that it will be useful, and can not control how the users are modifying it or using it. Therefore the program's authors will not be responsible for the users' behavior.

Please do not use this program to interfere with others' communication, or to spread harmful information or steal others' data, or to do anything prohibited by the law or the government.

License

This program is released under GNU General Public License version 3, see COPYING for details.

wifijam's Issues

Feature Request: Change Ssids in runtime

Can you add a function to change the ssids names at runtime? (i like to take for example the value or thermometer and i like to put as a ssid name). Thanks.

Switch to Scapy v2.4.0?

I noticed that your are using an outdate Scapy fork diverged, that does not follow evolutions and fixes from https://github.com/secdev/scapy

You should consider switching to scapy in you requirements.txt