I recommend you watch THIS video before you post a new issue to ask something.
A typical message you get in the web interface is the red
ERROR timeout loading file ... message.
It tells you that a transmission in the background failed.
This can happen because:
An often encoutered error by beginners is
.irom0.text' will not fit in region.
This error tells you that the compiled sketch doesn’t fit in the flash size you selected.
Most of the time it’s caused by the user selecting 512kb flash size, which is the default size for the generic esp8266 board.
So be sure to use the correct upload settings
Arduino usually prints a very long and unreadable compiler error message, but don’t let it confuse you. Most of those are warnings rather than errors.
If you just want to reset the settings you can open a serial connection and type in
The easiest way to do that is using the Arduino Serial monitor. The baudrate is
To erase the Deauther script including the WiFi credentials and everything that is saved in the SPIFFS, use our reset sketch: https://github.com/spacehuhn/esp8266_deauther/tree/master/Reset_Sketch
You can either compile and flash the .ino file with Arduino or flash one of the .bin files.
The ESP8266 supports 2.4GHz WiFi, which is already very impressive if you think about how small, powerful, accessible and affordable this system on a chip is!
A lot of people are asking for 5GHz support, however this project is not able to do that.
As of right now (2018) no hackable 5GHz SoC is available in the form of something like the ESP8266.
Even if someone would make such a chip, it would be incompatible with this software.
You could build a dual band Deauther with a Raspberry Pi and the right WiFi module.
But as of right now, it’s not always easy to find good Dual-Band WiFi chips that support packet injection and monitor mode.
⚠️ THE ESP8266 DOES NOT AND WILL NOT SUPPORT 5GHZ! ⚠️
Devices supporting this are more expensive and need special drivers (this will change in the future as new chips are released all the time).
But if you want to try it, look for the
rtl8811au WiFi modules. Those have already been used to inject packets at 5GHz.
See Supported Devices for more details.
While a jammer just creates noise on a specific frequency range (i.e. 2.4GHz), a deauthentication attack is only possible due to a vulnerability in the WiFi (802.11) standard. The deauther does not interfer with any frequencies, it is just sending a few WiFi packets that let certain devices disconnect. That enables you to specifically select every target. A jammer just blocks everything within a radius and is therefore highly illegal to use.
Watch this video for a good explanation on the technical and legal differences: 🎬 WiFi Jammers vs Deauthers | What’s The Difference?
The problem is that you can’t have an access point open to host the web server while sniffing WiFi.
It’s like with every other WiFi card. Either you use it as an access point to host a network, as a station to connect to one or you put it in monitor mode to sniff for packets. But you can’t have everything at the same time.
In Arduino click
Export compiled Binary and a new .bin file will be created in the sketch folder.
If you can’t find the COM port of your device, then you probably haven’t installed the right drivers yet. Here are the links to the drivers of the 2 most used UART chips:
If you’re not sure which chip your board is using, just try both.
A crash or exception can have a lot of reasons but before you open a new issue, try this:
resetto reset all settings
formatto remove all saved files in the on-board file system
There could be a lot of reasons why you can’t connect to the ESP8266 with certain devices.
For example, someone reported that the Intel 7260 WiFi Chip can make problems: https://github.com/spacehuhn/esp8266_deauther/issues/754
Arduino has example sketches for the ESP8266 to create an access point. You can try that out and see if you can connect to it. If not, then the problem is not related to this project’s code and you have to investigate your hardware/software setup further.
To erase the deauther you can just flash a different sketch. To overwrite the SPIFFS and EEPROM, you can flash our simple Reset Sketch.
espcom opening or
espcomm_sync failed error tells you that your computer couldn’t connect to the ESP8266 correctly when trying to upload something.
Be sure you have the correct COM port selected and use the correct upload settings.
If you can’t find the COM port, read Finding COM Port first.
Maybe you need to install the drivers.
Also be sure you use a USB data cable! Sometimes it also helps to restart Arduino or your computer, changing the cable or USB port.
It was also reported that the Windows-Insider-Program can make problems with the cp2102 drivers.
If everything else fails, try reflashing the Deauther. See Removing Deauther and then flash it again.
If you go to Settings in the web interface, you can change the language. For example
de is for the German language file.
To see what languages are supported, have a look at the lang folder or the description of the latest release.
If the language doesn’t change, it is probably because your browser has the old language file cached and doesn’t want to reload it. Try deleting your browser cache.
192.168.4.1/lang/default.lang and reload it one or two times.
If you get message like
Error saving file or something similar over serial, there is probably something wrong with the SPIFFS. It happens sometimes that the file system get corrupted for some reason. Usually you can fix it by running the
format command and then restarting the device.
If the error persists, please be sure that your upload settings are correct, especially the flash size.
This message pops up in the serial command line interface on versions 2.0.0 - 2.0.6.
In version 2.1.0 it’s commented out, due to the big amount of people that reported it as a error.
It tells you that a file was requested by the client, that couldn’t be found in the ESP8266 memory.
This usually occurs because client devices want to check whether or not the network has a connection to the internet.
This is not a bug, it’s a feature. To disable it, you have to set the
attackTimeout setting to