up

Author: Ishanoshada

README.md

@@ -1,11 +1,36 @@
 # ESP32 Deauthentication Tool
+
+
 A powerful, cross-platform Python toolkit for Wi-Fi deauthentication testing using only an ESP32 board and a data cable. With a simple command-line interface and interactive menus, you can easily erase and flash your ESP32, scan for Wi-Fi networks, and launch a variety of wireless attacks—all from your terminal. The tool also provides seamless WiFi reconnection to the ESP32's ManagementAP WiFi network (**SSID:** `ManagementAP`, **password:** `mgmtadmin`) on Windows, Linux, and macOS.
 
 Supports continuous or unlimited attack looping—run attacks in a loop for as long as needed (e.g., for stress testing or research).
 
+
+<center>
+
+![video.gif](/src/video.gif)
+
+</center>
 > **⚠️ Legal Notice:**  
 > Deauthentication attacks are illegal without explicit permission from the network owner. This tool is intended strictly for educational, research, and authorized penetration testing purposes. Use responsibly and only on networks you own or have written authorization to test. The authors disclaim all liability for misuse.
 
+## Required Hardware
+
+To use the ESP32 Deauthentication Tool, you will need:
+
+- **ESP32 Board:**  
+    Any ESP32 development board (e.g., ESP32-WROOM-32) is supported.  
+    > The tool is designed for use with standard ESP32 boards and has been tested with models such as the ESP32-WROOM-32.
+
+- **USB Data Cable:**  
+    A USB cable with data lines (not just charging) to connect the ESP32 to your computer for flashing and serial communication.
+
+- **Computer:**  
+    A Windows, Linux, or macOS machine with Python 3.7+ installed.
+
+No additional Wi-Fi adapters or special hardware are required—just a standard ESP32 board and a USB cable.
+
+![img](/src/pic.jpg)
 
 ## ✨ Features
 

esp32_deauth/deauth.py

@@ -547,7 +547,14 @@ def attack_network(self, ap, attack_type, attack_method, timeout, continuous=Fal
                             status = self.get_status()
                         except:
                             status  = ""
+                        
                         if status:
+                            try:
+                                if status["state"] == 0:
+                                    print("Sometimes, 5G Wi-Fi networks can't be attacked.")
+                                    break
+                            except:
+                                pass
                             if status['state'] in [self.attack_state_enum['FINISHED'], self.attack_state_enum['TIMEOUT']]:
                                 logger.info(f"Attack {'completed' if status['state'] == self.attack_state_enum['FINISHED'] else 'timed out'}")
                                 if status['state'] == self.attack_state_enum['FINISHED']:
@@ -571,6 +578,27 @@ def attack_network(self, ap, attack_type, attack_method, timeout, continuous=Fal
                         if status and status['state'] == self.attack_state_enum['RUNNING']:
                             logger.error("Attack did not complete within timeout, resetting...")
                             self.reset_attack()
+                        # Ask user if they want to try reconnecting (up to 6 attempts)
+                        for attempt in range(6):
+                            user_input = input("Attack status is failing or timing out. The Wi-Fi connection may be lost. Try reconnecting? (y/n): ").strip().lower()
+                            if user_input == 'y':
+                                logger.info(f"Attempting to reconnect to ManagementAP (attempt {attempt + 1}/6)...")
+                                if self.reconnect_wifi() and self.check_api_connectivity():
+                                    logger.info("Reconnected successfully. Retrying attack...")
+                                    status = self.get_status()
+                                    if status and status['state'] == self.attack_state_enum['RUNNING']:
+                                        logger.error("Attack did not complete within timeout, resetting...")
+                                        self.reset_attack()
+                                else:
+                                    logger.error("Reconnect failed.")
+                            elif user_input == 'n':
+                                logger.info("Exiting attack loop.")
+                                return False
+                            else:
+                                logger.error("Invalid input. Please enter 'y' or 'n'.")
+                        else:
+                            logger.info("Maximum reconnect attempts reached. Exiting attack loop.")
+                            return False
                 else:
                     logger.error("Failed to initiate attack, possibly AP is off. Retrying after reconnect...")
                     self.reconnect_wifi()

setup.py

@@ -5,7 +5,7 @@
 
 setup(
     name="esp32-deauth",
-    version="0.3.2",
+    version="0.3.3",
     description="A Python tool for Wi-Fi deauthentication attacks using ESP32 with webserver firmware",
     long_description=long_description,
     long_description_content_type="text/markdown",