first commit
This commit is contained in:
TemanSv1n
90
README.md
Normal file
90
README.md
Normal file
@@ -0,0 +1,90 @@
|
||||
<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)
|
||||
|
||||
<!-- 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 НО там нужно гунить на байты
|
||||
|
||||
Reference in New Issue
Block a user