|
1 |
| -# ESP8266 Deauther Version 2 |
| 1 | +# ESP8266 Deauther |
2 | 2 |
|
3 |
| -<p align="center"> |
4 |
| - <img alt="PICTURE logo" src="https://raw.githubusercontent.com/wiki/spacehuhn/esp8266_deauther/img/deauther_logo.png" width="200"> |
5 |
| - <br> |
6 |
| - <b>Scan for WiFi devices, block selected connections, create dozens of networks and confuse WiFi scanners!</b> |
7 |
| - <br> |
8 |
| - <br> |
9 |
| -</p> |
| 3 | +<img src='https://deauther.com/img/logo.png' alt='Deauther Logo' width='200' /> |
10 | 4 |
|
11 |
| -## Difference to Version 3 |
| 5 | +**Scan for WiFi devices, block selected connections, create dozens of networks and confuse WiFi scanners.** |
12 | 6 |
|
13 |
| -[Version 3](https://github.com/SpacehuhnTech/esp8266_deauther/tree/v3) is in development. It is stable to use, but it is very different. |
14 |
| -It is command line based, which allows it to offer not just more features, but make them more customizable. |
| 7 | +## New Documentation |
15 | 8 |
|
16 |
| -| Feature | Version 2 | Version 3 | |
17 |
| -| ------- | --------- | --------- | |
18 |
| -| Web Interface | ✅ | | |
19 |
| -| Display support | ✅ | | |
20 |
| -| Serial Command Line | ✅ | ✅ | |
21 |
| -| Scanner | ✅ | ✅ | |
22 |
| -| Deauth attack | ✅ | ✅ | |
23 |
| -| Beacon attack | ✅ | ✅ | |
24 |
| -| Probe attack | ✅ | ✅ | |
25 |
| -| [Huhnitor](https://github.com/spacehuhntech/huhnitor) support | | ✅ | |
26 |
| -| Signal strength scanner | | ✅ | |
27 |
| -| Authentication scanner | | ✅ | |
28 |
| -| Rogue AP | | ✅ | |
| 9 | +Hi 👋 |
| 10 | +Please visit [Deauther.com](https://deauther.com) for information about this project. |
| 11 | +Here are some quick links: |
29 | 12 |
|
30 |
| -## Installation |
| 13 | +* [Buy](https://deauther.com/docs/buy) |
| 14 | +* [Download](https://deauther.com/docs/download) |
| 15 | +* [DIY Tutorial](https://deauther.com/docs/category/diy-tutorial) |
| 16 | +* [Usage](https://deauther.com/docs/category/usage) |
| 17 | +* [FAQ](https://deauther.com/docs/faq) |
31 | 18 |
|
32 |
| -Please refer to the [installation guide in our wiki](https://github.com/spacehuhntech/esp8266_deauther/wiki/Installation). |
33 |
| -If you're just looking for the .bin files, go to [releases](https://github.com/spacehuhn/esp8266_deauther/releases). |
| 19 | +## Password |
34 | 20 |
|
35 |
| -## About this project |
36 |
| -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). |
| 21 | +The password for `pwned` is `deauther` |
37 | 22 |
|
38 |
| -The main feature, the deauthentication attack, is used to disconnect devices from their WiFi network. |
39 |
| -No one seems to care about this huge vulnerability in the official 802.11 WiFi standard, so I took action and enabled everyone who has less than 10 USD to spare to recreate this project. |
40 |
| -I hope it raises more attention on the issue. In 2009 the WiFi Alliance actually fixed the problem (see [802.11w](https://en.wikipedia.org/wiki/IEEE_802.11w-2009)), but only a few companies implemented it into their devices and software. |
41 |
| -To effectively prevent a deauthentication attack, both client and access point must support the 802.11w standard with protected management frames (PMF). |
42 |
| -While most client devices seem to support it when the access point forces it, basically no WiFi access point has it enabled. |
| 23 | +## About this Project |
43 | 24 |
|
44 |
| -Feel free to test your hardware out, annoy these companies with the problem, share this project and push for a fix! |
45 |
| -This project is also a great way to learn more about WiFi, micro controllers, Arduino, hacking and electronics/programming in general. |
46 |
| -**But please use this tool responsibly and do not use it against others without their permission!** |
| 25 | +This firmware allows you to easily perform a variety of actions to test 802.11 networks using an [ESP8266](https://www.espressif.com/en/products/socs/esp8266). It's also a great project for learning about WiFi, microcontrollers, Arduino, hacking and electronics/programming in general. |
47 | 26 |
|
48 |
| -## WiFi Jammer |
49 |
| - |
50 |
| -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. |
51 |
| - |
52 |
| -So if you like to learn more about the difference, we made a whole video about it: |
53 |
| -[](https://www.youtube.com/watch?v=gOyfD44A7rE) |
54 |
| - |
55 |
| -## Supported Development Boards |
56 |
| - |
57 |
| -This firmware can run on any **ESP8266**, not however on the ESP32! |
58 |
| -The most popular development boards, the `NodeMCU` and `Wemos d1 mini`, work great for this project. |
59 |
| - |
60 |
| -If you like to support our work, you can buy get a boards made with this project in mind. |
61 |
| -They come preflashed with the firmware, so you can start right away. |
62 |
| -You can chose between: |
63 |
| - |
64 |
| -**[Spacehuhn Store](https://spacehuhn.store)**: |
65 |
| -Our very own store where all revenue goes directly to us and towards the development of new and exciting projects :) |
66 |
| -We manufacture and ship from Germany. |
67 |
| - |
68 |
| -**[Maltronics](https://maltronics.com/)**: |
69 |
| -We partnered with Maltronics to bring you high quality hacking gadgets. |
70 |
| -They are based in the UK. |
71 |
| - |
72 |
| -**[DSTIKE](https://dstike.com/)**: |
73 |
| -DSTIKE was our first partner. They manufactured the first official deauther boards. |
74 |
| -They offer a wide range of deauthers in a variety of form factors, including a smart watch. |
75 |
| -They are based in China, but their products are available through a variety of stores: |
76 |
| -- [Tindie](https://tindie.com/stores/lspoplove) |
77 |
| -- [AliExpress](https://dstike.aliexpress.com/store/2996024) |
78 |
| -- [Taobao](https://shop135375846.taobao.com) |
| 27 | +The deauthentication attack is the main feature, which can be used to disconnect devices from their WiFi network. |
| 28 | +Although this denial-of-service attack is nothing new, a lot of devices are still vulnerable to it. Luckily this is slowly changing with more WiFi 6 enabled devices being used. But a lot of outdated WiFi devices remain in place, for example in cheap IoT hardware. |
| 29 | +With an ESP8266 Deauther, you can easily test this attack on your 2.4GHz WiFi network/devices and see whether it's successful or not. And if it is, you know you should upgrade your network. |
79 | 30 |
|
80 | 31 | ## Disclaimer
|
81 | 32 |
|
82 | 33 | This project is a proof of concept for testing and educational purposes.
|
83 |
| -Neither the ESP8266, nor its SDK was meant or built for such purposes. Bugs can occur! |
| 34 | +Neither the ESP8266, nor its SDK was meant or built for such purposes. **Bugs can occur!** |
84 | 35 |
|
85 |
| -Use it only against your own networks and devices! |
| 36 | +**Use it only against your own networks and devices!** |
86 | 37 | Please check the legal regulations in your country before using it.
|
87 |
| -We don't take any responsibility for what you do with this program. |
88 |
| - |
89 |
| -## Acknowledgements |
90 |
| - |
91 |
| -A huge thanks to: |
92 |
| - |
93 |
| -- [@deantonious](http://github.com/deantonious) |
94 |
| -- [@jLynx](https://github.com/jLynx) |
95 |
| -- [@lspoplove](https://github.com/lspoplove) |
96 |
| -- [@schinfo](https://github.com/schinfo) |
97 |
| -- [@tobozo](https://github.com/tobozo) |
98 |
| -- [@xdavidhu](https://github.com/xdavidhu) |
99 |
| -- [@PwnKitteh](https://github.com/PwnKitteh) |
100 |
| - |
101 |
| -for helping out with various things regarding this project and keeping it alive! |
102 |
| -Also thanks to everyone working on the libraries used for this project: |
103 |
| - |
104 |
| -- [esp8266-oled-ssd1306](https://github.com/ThingPulse/esp8266-oled-ssd1306) |
105 |
| -- [ArduinoJson](https://github.com/bblanchon/ArduinoJson) |
106 |
| -- [Adafruit_DotStar](https://github.com/adafruit/Adafruit_DotStar) |
107 |
| -- [Adafruit_NeoPixel](https://github.com/adafruit/Adafruit_NeoPixel) |
108 |
| -- [DS3231](https://github.com/NorthernWidget/DS3231) |
109 |
| -- [my92xx](https://github.com/xoseperez/my92xx) |
110 |
| - |
111 |
| -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! |
112 |
| - |
113 |
| -## License |
114 |
| - |
115 |
| -This software is licensed under the MIT License. See the [license file](LICENSE) for details. |
| 38 | +We don't take any responsibility for what you do with this program. |
0 commit comments