Skip to content

Commit 8715dc5

Browse files
author
Spacehuhn
committed
Updated README.md
1 parent 10e3c82 commit 8715dc5

File tree

1 file changed

+60
-57
lines changed

1 file changed

+60
-57
lines changed

README.md

Lines changed: 60 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,34 @@
1-
# ESP8266 Deauther 2.0
1+
# ESP8266 Deauther Version 2
22

33
<p align="center"><img alt="PICTURE logo" src="https://raw.githubusercontent.com/wiki/spacehuhn/esp8266_deauther/img/deauther_logo.png" width="200"></p>
44

5-
<p align="center">
6-
🐦 <a href="https://twitter.com/spacehuhn">Twitter</a>
7-
| 📺 <a href="https://www.youtube.com/channel/UCFmjA6dnjv-phqrFACyI8tw">YouTube</a>
8-
| 🌍 <a href="https://spacehuhn.de">spacehuhn.de</a><br>
9-
<br>
105
<b>Scan for WiFi devices, block selected connections, create dozens of networks and confuse WiFi scanners!<br><br>
11-
Click <a href="https://github.com/spacehuhn/esp8266_deauther/wiki/Installation">here</a> for the installation tutorial.<br>
12-
Click <a href="https://github.com/spacehuhn/esp8266_deauther/releases">here</a> for the .bin files.<br><br>
13-
Support the development of this project by purchasing one of the <a href="https://github.com/spacehuhn/esp8266_deauther/wiki/Supported-Devices">official deauther boards</a>.<br/>
14-
Or become a patron on <a href="https://patreon.com/spacehuhn" target="_blank">patreon.com/spacehuhn</a>.<br>
15-
Also available: <a href="https://www.tindie.com/products/Spacehuhn/spacehuhn-stickers/">Stickers</a></b>!
6+
167
</p>
178

18-
# [👉 Wiki](https://github.com/SpacehuhnTech/esp8266_deauther/wiki)
19-
# [👉 Binaries](https://github.com/SpacehuhnTech/esp8266_deauther/releases)
20-
# [👉 Development Boards](https://github.com/SpacehuhnTech/esp8266_deauther/wiki/Supported-Devices)
21-
22-
## What is New
23-
[Here is a quick video about what is new](https://youtu.be/6oRmm3xfp6U)
24-
Version 2.0:
25-
- Completly rewritten code base for better performance and later enhancements
26-
- Custom Deauther SDK for easy compiling using Arduino
27-
- New serial command line interface to control and debug the program
28-
- New display UI with a lot of new functions
29-
- Improved web interface with multi-language support
30-
- Improved scanning for access points and stations (+ continuous scanning mode)
31-
- Save and select device names for both scanning and attacking
32-
- Save up to 60 SSIDs and 25 devices in one list (you can create, load and save multiple lists)
33-
- Added [PacketMonitor](https://github.com/spacehuhn/PacketMonitor) to display UI
34-
- Deauth detection when scanning
35-
- RGB LED support for a quick indication what the device is doing (attacking, scanning, ...)
36-
- Better documentation on the new [wiki](https://github.com/spacehuhn/esp8266_deauther/wiki)
9+
## Difference to Version 3
10+
11+
[Version 3](https://github.com/SpacehuhnTech/esp8266_deauther/tree/v3) is in development. It is stable to use, but it is very different.
12+
It is command line based, which allows it to offer not just more features, but make them more customizable.
13+
14+
| Feature | Version 2 | Version 3 |
15+
| ------- | --------- | --------- |
16+
| Web Interface || |
17+
| Display support || |
18+
| Serial Command Line |||
19+
| Scanner |||
20+
| Deauth attack |||
21+
| Beacon attack |||
22+
| Probe attack |||
23+
| [Huhnitor](https://github.com/spacehuhntech/huhnitor) support | ||
24+
| Signal strength scanner | ||
25+
| Authentication scanner | ||
26+
| Rogue AP | ||
27+
28+
## Installation
29+
30+
Please refer to the [installation guide in our wiki](https://github.com/spacehuhntech/esp8266_deauther/wiki/Installation).
31+
If you're just looking for the .bin files, go to [releases](https://github.com/spacehuhn/esp8266_deauther/releases).
3732

3833
## About this project
3934
This software allows you to easily perform a variety of actions to test 802.11 wireless networks by using an inexpensive ESP8266 WiFi SoC (System On A Chip).
@@ -48,44 +43,51 @@ Feel free to test your hardware out, annoy these companies with the problem, sha
4843
This project is also a great way to learn more about WiFi, micro controllers, Arduino, hacking and electronics/programming in general.
4944
**But please use this tool responsibly and do not use it against others without their permission!**
5045

51-
The difference between deauthing and jamming: [click me](https://github.com/spacehuhn/esp8266_deauther/wiki/FAQ#difference-between-jammer-and-deauther)
46+
## WiFi Jammer
47+
48+
Many refer to this project as a WiFi jammer. This is problematic, because this firmware is **not** turning your ESP8266 into a radio or frequency jammer. But this is how most people imagine it without further explaination.
49+
50+
So if you like to learn more about the difference, we made a whole video about it:
51+
[![Deauther or Jammer: What's the difference?](https://img.youtube.com/vi/gOyfD44A7rE/0.jpg)](https://www.youtube.com/watch?v=gOyfD44A7rE)
52+
53+
## Supported Development Boards
5254

53-
## Official Deauther Boards
55+
This firmware can run on any **ESP8266**, not however on the ESP32!
56+
The most popular development boards, the `NodeMCU` and `Wemos d1 mini`, work great for this project.
5457

55-
![PICTURE DSTIKE Deauther OLED Board](https://raw.githubusercontent.com/wiki/spacehuhn/esp8266_deauther/img/DSTIKE_Deauther_Board.jpg)
58+
If you like to support our work, you can buy get a boards made with this project in mind.
59+
They come preflashed with the firmware, so you can start right away.
60+
You can chose between:
5661

57-
If you want to support the development of this project, you can buy one of the official boards by DSTIKE (Travis Lin) on following sites:
62+
**[Spacehuhn Store](https://spacehuhn.store)**:
63+
Our very own store where all revenue goes directly to us and towards the development of new and exciting projects :)
64+
We manufacture and ship from Germany.
65+
66+
**[Maltronics](https://maltronics.com/)**:
67+
We partnered with Maltronics to bring you high quality hacking gadgets.
68+
They are based in the UK.
69+
70+
**[DSTIKE](https://dstike.com/)**:
71+
DSTIKE was our first partner. They manufactured the first official deauther boards.
72+
They offer a wide range of deauthers in all kind of form factores. Including a smart watch.
73+
They are based in China, but their products are available through a variety of stores:
5874
- [Tindie](https://tindie.com/stores/lspoplove)
5975
- [AliExpress](https://dstike.aliexpress.com/store/2996024)
6076
- [Taobao](https://shop135375846.taobao.com)
6177

62-
Those boards are optimized for this project, ready to use and come preflashed with the Deauther software!
63-
For more details visit the [Wiki](https://github.com/spacehuhn/esp8266_deauther/wiki) under [Supported Devices](https://github.com/spacehuhn/esp8266_deauther/wiki/Supported-Devices).
64-
6578
## Disclaimer
79+
6680
This project is a proof of concept for testing and educational purposes.
6781
Neither the ESP8266, nor its SDK was meant or built for such purposes. Bugs can occur!
6882

6983
Use it only against your own networks and devices!
7084
Please check the legal regulations in your country before using it.
71-
I don't take any responsibility for what you do with this program.
85+
We don't take any responsibility for what you do with this program.
7286

73-
It is **not a frequency jammer** as claimed falsely by many people. Its attack, its method and how to protect against it is described above. It uses valid Wi-Fi frames described in the IEEE 802.11 standard and doesn't block or disrupt any frequencies.
87+
## Acknowledgements
7488

75-
This project is meant to draw more attention on this issue.
76-
The [deauthentication](https://en.wikipedia.org/wiki/Wi-Fi_deauthentication_attack) attack shows how vulnerable the 802.11 Wi-Fi standard is and that it has to be fixed.
77-
A solution is already there, why don't we use it?
89+
A huge thanks to:
7890

79-
**Please don't refer to this project as "jammer", that totally undermines the real purpose of this project!**
80-
If you do, it only proves that you didn't understand anything of what this project stands for. Publishing content about this without a proper explanation shows that you only do it for the clicks, fame and/or money and have no respect for intellectual property, the community behind it and the fight for a better WiFi standard!
81-
82-
## Getting Started
83-
84-
Visit our new [Wiki](https://github.com/spacehuhn/esp8266_deauther/wiki) on how to recreate this project and use it.
85-
Happy Hacking!
86-
87-
## Credits
88-
A huge thanks to:
8991
- [@deantonious](http://github.com/deantonious)
9092
- [@jLynx](https://github.com/jLynx)
9193
- [@lspoplove](https://github.com/lspoplove)
@@ -95,15 +97,16 @@ A huge thanks to:
9597
- [@PwnKitteh](https://github.com/PwnKitteh)
9698

9799
for helping out with various things regarding this project and keeping it alive!
100+
Also thanks to everyone working on the libraries used for this project:
98101

99-
I also want to thank Espressif and their community for this awesome chip and all the software and hardware projects around it and the countless tutorials you can find online!
100-
101-
Shoutout to everyone working on the libraries used for this project:
102102
- [esp8266-oled-ssd1306](https://github.com/ThingPulse/esp8266-oled-ssd1306)
103103
- [ArduinoJson](https://github.com/bblanchon/ArduinoJson)
104-
- [LinkedList](https://github.com/ivanseidel/LinkedList)
104+
- [Adafruit_DotStar](https://github.com/adafruit/Adafruit_DotStar)
105+
- [Adafruit_NeoPixel](https://github.com/adafruit/Adafruit_NeoPixel)
106+
- [DS3231](https://github.com/NorthernWidget/DS3231)
107+
- [my92xx](https://github.com/xoseperez/my92xx)
105108

106-
Also thanks to everyone that supports this project by [donating](http://spacehuhn.de/donate), being my [patron](http://patreon.com/spacehuhn) or buying one of the [official Deauther boards](https://www.tindie.com/stores/lspoplove) from DSTIKE.
109+
We also thank Espressif and their community for this awesome chip and all the software and hardware projects around it and the countless tutorials you can find online!
107110

108111
## License
109112

0 commit comments

Comments
 (0)