Skip to content

An open-source ESP8266_Deauther with customizable Evil Twin attack, and WiFi signal strength checker, with a user-friendly web interface and Display interface and more.

License

Notifications You must be signed in to change notification settings

BlackTechX011/DeautherX

Repository files navigation

DeautherX

DeautherX

An open-source ESP8266_Deauther with customizable Evil Twin attack, and WiFi signal strength checker, with a user-friendly web interface and Display interface and more.

BlackTechX - DeautherX stars - DeautherX forks - DeautherX


📔 Table of Contents

🌟 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.

📚 Documentation

Please visit the DeautherX docs for detailed information about this project. Here is quick link:

https://blacktechx011.github.io/DeautherX_Docs/

🔒 Password

The password for DeautherX is BlackTechX.

🚀 Automatic Installation

  1. Visit DeautherX Web Tools.
  2. Select your ESP8266 board.
  3. Select display type.
  4. Connect your ESP8266 board via USB.
  5. Click Connect and select the serial port of your ESP.
  6. On the Device Dashboard, click on install.

🔧 Installation with Arduino IDE

  1. Install the Arduino IDE.
  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

This project is a proof of concept for testing and educational purposes. Neither the ESP8266 nor its SDK was meant or built for such purposes. Bugs can occur!

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

For more information, visit DeautherX on Hashnode.

✨ Special Thanks

Special thanks to DX4GREY for their contributions.

👋 Feedback

If you have any feedback or queries, please create an issue on this repository.