98 lines
5.0 KiB
Markdown
98 lines
5.0 KiB
Markdown
<div align="center">
|
||
|
||
<img src="https://raw.githubusercontent.com/BlackTechX011/DeautherX/DeautherX_V1/img/DeautherX.png" alt="DeautherX" width="370" height="500" />
|
||
<h1>DeautherX</h1>
|
||
|
||
<p>
|
||
Special 04K revision of ESP8266_Deauther with customizable Evil Twin attack, and WiFi signal strength checker, with a user-friendly web interface and Display interface and more.
|
||
Чертежи для печати и инструкции по сборке в соседней ветке!!!
|
||
</p>
|
||
|
||
<!-- Badges -->
|
||
<p>
|
||
<a href="https://github.com/BlackTechX011/DeautherX" title="Go to GitHub repo"><img src="https://img.shields.io/static/v1?label=BlackTechX&message=DeautherX&color=blue&logo=github" alt="BlackTechX - DeautherX"></a>
|
||
<a href="https://github.com/BlackTechX011/DeautherX"><img src="https://img.shields.io/github/stars/BlackTechX011/DeautherX?style=social" alt="stars - DeautherX"></a>
|
||
<a href="https://github.com/BlackTechX011/DeautherX"><img src="https://img.shields.io/github/forks/BlackTechX011/DeautherX?style=social" alt="forks - DeautherX"></a>
|
||
</p>
|
||
|
||
<h4>
|
||
<a href="https://www.GitHub.com/BlackTechX011/">GITHUB</a>
|
||
</h4>
|
||
</div>
|
||
|
||
<br />
|
||
|
||
<!-- Table of Contents -->
|
||
# :notebook_with_decorative_cover: Table of Contents
|
||
|
||
- [About the Project](#star2-about-the-project)
|
||
- [Documentation](#books-documentation)
|
||
- [Password](#lock-password)
|
||
- [Installation with Arduino IDE](#wrench-installation-with-arduino-ide)
|
||
- [Disclaimer](#warning-disclaimer)
|
||
- [Variables](#warning-variables)
|
||
- [Assembly scheme](#warning-assembly-scheme)
|
||
|
||
<!-- About the Project -->
|
||
## :star2: About the Project
|
||
|
||
This firmware allows you to easily perform a variety of actions to test 802.11 networks using an ESP8266. It's also a great project for learning about WiFi, microcontrollers, Arduino, hacking, and electronics/programming in general.
|
||
|
||
The deauthentication attack is the main feature, which can be used to disconnect devices from their WiFi network.
|
||
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. 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.
|
||
|
||
To know more about deauthentication, visit [WiFi Deauthentication Frame Explained](https://blog-blacktechx.hashnode.dev/wifi-deauthentication-frame-explained).
|
||
|
||
**Чертежи для печати и инструкции по сборке в соседней ветке!!!**
|
||
|
||
<!-- Documentation -->
|
||
## :books: Documentation
|
||
|
||
Please visit the [DeautherX docs](https://blacktechx011.github.io/DeautherX_Docs/) for detailed information about this project. Here is quick link:
|
||
- [Home](https://blacktechx011.github.io/DeautherX_Docs/)
|
||
```
|
||
https://blacktechx011.github.io/DeautherX_Docs/
|
||
```
|
||
|
||
|
||
|
||
<!-- Password -->
|
||
## :lock: Password
|
||
|
||
The password for `ZeeXyL19-kv84` is `19841488`.
|
||
|
||
<!-- Installation with Arduino IDE -->
|
||
## :wrench: Installation with Arduino IDE
|
||
|
||
1. Install the [Arduino IDE](https://www.arduino.cc/en/Main/Software).
|
||
2. Go to **File** -> **Preferences** -> **Additional Boards Manager URLs** and add:
|
||
`https://raw.githubusercontent.com/BlackTechX011/arduino/main/package_BlackTechX_index.json`
|
||
3. Go to `Tools` -> `Board` -> `Boards Manager` and install `DeautherX ESP8266`.
|
||
4. Open the DeautherX code folder.
|
||
5. Open `DeautherX.ino` with Arduino IDE.
|
||
6. Select the port.
|
||
7. Go to `Tools` -> `Board` -> `Boards Manager` and select your DeautherX board from `DeautherX ESP8266 boards`.
|
||
8. Click on upload.
|
||
|
||
<!-- Disclaimer -->
|
||
## :warning: Disclaimer
|
||
|
||
Ревизия DeautherX специально для ОЧК НКСП.
|
||
|
||
<!-- Variables -->
|
||
## :warning: Variables
|
||
|
||
Автор оригинального репозитория гомогей и напихал в код кучу разных штук, которые по хорошему каждый хотел бы кастомизировать, но нигде не упорядочил. Так вот, список файлов, где есть некоторые настройки:
|
||
- Форматирование при перезапуске: A_Config.h первые строки
|
||
- Назначения кнопок: A_Config.h в ПЕРВОЙ секции buttons
|
||
- Название и пароль от сетки: A_Config.h AP_SSID ; AP_PASSWD
|
||
- ip точки: A_Config.h WEB_IP_ADDR
|
||
- Светодиоды: led.cpp
|
||
- Надпись при инициализации: DisplayUI.cpp: drawIntro() И DisplayUI.h: первые строки
|
||
- Дефолтные названия фантомных точек: language.h SS_JSON_DEFAULT
|
||
- Файлы сайта: webfiles.h НО там нужно гунить на байты
|
||
|
||
<!-- Assembly scheme -->
|
||
## :warning: Assembly scheme
|
||
**Чертежи для печати и инструкции по сборке в соседней ветке!!!**
|