https://github.com/tesa-klebeband/rtl8720dn-deauther

My ESP32-Deauther ported to the RTL8720dn, allowing users to deauthenticate on 5GHz now!
https://github.com/tesa-klebeband/rtl8720dn-deauther

pentesting rtl8720dn wifi-hacking

Last synced: 5 days ago
JSON representation

My ESP32-Deauther ported to the RTL8720dn, allowing users to deauthenticate on 5GHz now!

• Host: GitHub
• URL: https://github.com/tesa-klebeband/rtl8720dn-deauther
• Owner: tesa-klebeband
• License: gpl-3.0
• Created: 2024-08-11T18:35:45.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2024-11-24T20:41:47.000Z (about 2 months ago)
• Last Synced: 2025-01-08T12:05:29.178Z (12 days ago)
• Topics: pentesting, rtl8720dn, wifi-hacking
• Language: C++
• Homepage:
• Size: 29.3 KB
• Stars: 122
• Watchers: 4
• Forks: 15
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# RTL8720dn-Deauther

![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/tesa-klebeband/RTL8720dn-Deauther)

![GitHub License](https://img.shields.io/github/license/tesa-klebeband/RTL8720dn-Deauther)

![GitHub Repo stars](https://img.shields.io/github/stars/tesa-klebeband/RTL8720dn-Deauther?style=flat)

![GitHub forks](https://img.shields.io/github/forks/tesa-klebeband/RTL8720dn-Deauther?style=flat)

![logo](https://github.com/user-attachments/assets/ab8ebf84-eee2-4298-8975-2e8dad13c1b3)

My ESP32-Deauther ported to the RTL8720dn, allowing users to deauthenticate on 5Ghz now!

# DISCLAIMER

This tool has been made for educational and testing purposes only. Any misuse or illegal activities conducted with the tool are strictly prohibited. I am **not** responsible for any consequences arising from the use of the tool, which is done at your own risk.

## Building

Building is done using the ArduinoIDE. Make sure you have added the board manager URL for Realtek MCUs and installed them in the board manager.

1) Clone this repo using `git clone https://github.com/tesa-klebeband/RTL8720dn-Deauther.git`

2) Open the cloned folder in the Arduino IDE

3) Connect your board and hit upload

### Notes

Most RTL8720dn devboards have the upload and log serial ports isolated. Make sure to bridge **LOG_UART_TX** and **LP_UART_TX**, as well as **LOG_UART_RX** and **LP_UART_RX** during uploading.

## Using RTL8720dn-Deauther

The RTL8720dn hosts a WiFi network with the name of `RTL8720dn-Deauther` and a password of `0123456789`. Connect to this network and type the IP of your RTL8720dn (typically **192.168.1.1**) into a webbrowser of a choice.

### Rescan networks

Rescan and detect all WiFi networks in your area. After a successful scan, the networks are listed in the above table.

### Launch Deauth-Attack

Deauthenticates all clients connected to one or multiple networks. Select the networks you want to deauth in the table above, and enter a reason code in the reason field (2 works best in most cases) from the table below. After that, click **Launch Deauth-Attack**

### Stopping a Deauth-Attack

Unlike in previous versions, stopping a deauth requires you to reset the board. This can be done by pressing the reset button on the board or by unplugging and replugging the board. It is not possible to implement a button on the website, as the board is constantly switching channels.

### Leds

The RTL8720dn-Deauther utilizes the RGB led that most devboards have. This is what the different colors indicate:

* Red: The system state. Lights up when the system is usable.

* Green: Lights up when a HTTP communication between a device and the Deauther is happening.

* Blue: Flashes when a deauth frame is being sent.

## License

All files within this repo are released under the GNU GPL V3 License as per the LICENSE file stored in the root of this repo.