🎛️ Evil-BW16 Control Panel

⚠️ Disclaimer:

Evil-BW16 is crafted exclusively for educational and ethical testing purposes. Misuse or illegal application of this tool is strictly forbidden. The creator of Evil-BW16 declines any liability and is not responsible for any misuse or damage caused by this tool. Users must adhere to all applicable laws and regulations in their jurisdiction regarding network testing and ethical hacking.

---

📖 Table of Contents

• ✨ Introduction
• 🚀 Features
• 🛠️ Requirements
• 💻 Software
• 🔧 Hardware
• 📦 Installation
• 🎯 Usage
• 🔌 Connecting to the Device
• 📝 Commands
• ⚙️ Setting Parameters
• 🎯 Targeting APs
• 🛠️ Custom Commands
• 🔘 System Tray
• 📄 License
• 🤝 Contributing
• 📬 Contact
• Credits

---

✨ Introduction

Welcome to the Evil-BW16 Control Panel – your sleek and intuitive graphical interface built with Tkinter for managing the powerful Evil-BW16 device. Designed for WiFi network testing and ethical hacking, Evil-BW16 empowers you to:

• Scan for WiFi networks
• Send deauthentication frames
• Target specific access points (APs)

Whether you're a cybersecurity enthusiast or a professional tester, our control panel simplifies complex operations, making your ethical hacking endeavors both efficient and effective.

🚀 Features

• 🔌 Serial Port Management:
• Seamlessly connect/disconnect from serial ports.

• Dynamically refresh available serial ports.

• 📝 Command Execution:

• Execute predefined commands: start deauther, stop deauther, scan, results, info, help, start sniff, sniff beacon, sniff probe, sniff deauth, sniff eapol, sniff pwnagotchi, sniff all, stop sniff, hop on, hop off.

• Send custom commands for experimental features.

• ⚙️ Parameter Configuration:

• Configure settings like cycle delay, scan time, number of frames, start channel, scan cycles, LED control, hop interval, sniff mode, and channel band.

• Apply multiple parameters simultaneously with ease.

• Debug and Help:

• Toggle debug mode for detailed device diagnostics.

• Access comprehensive help documentation through the help window.

• 🎯 Targeting APs:

• Specify target AP indices to focus deauthentication attacks on selected networks.

• 🔘 System Tray Integration:

• Minimize the application to the system tray.

• Easily restore or quit the application from the tray icon.

• 📜 Device Output Logging:

• Real-time display of device responses and logs for comprehensive monitoring.

🛠️ Requirements

💻 Software

• Python 3.6 or Higher
• Libraries:
• customtkinter
• pystray
• Pillow
• pyserial

📥 Installation of Python Libraries

Install the necessary Python libraries using pip:

pip install customtkinter pystray Pillow pyserial

🔧 Hardware

• 🖥️ Evil-BW16 Device: Ensure your Evil-BW16 hardware is properly connected to your computer via a serial connection (e.g., USB).
• 🖼️ Icon File: An icon.ico file is required for the application and system tray icons. Place this file in the same directory as the application script.

📦 Installation

1. 🔍 Clone the Repository:

bash git clone https://github.com/dagnazty/Evil-BW16-Control-Panel.git cd Evil-BW16-Control-Panel

1. 📦 Install Dependencies:

Ensure all required Python libraries are installed as outlined in the Requirements section.

1. 🖼️ Prepare the Icon:

Make sure you have an icon.ico file in the project directory. This icon will represent both the application window and the system tray.

🎯 Usage

Launch the Evil-BW16 Control Panel with Python:

python evil_bw16_gui.py

🔌 Connecting to the Device

1. 📡 Select Serial Port:
2. Choose the appropriate COM port from the "Serial Port" dropdown connected to your Evil-BW16 device.

3. Click the "Refresh" button to update the list of available ports.

4. 🔢 Select Baud Rate:

5. Select the desired baud rate from the "Baud Rate" dropdown. The default is 115200.

6. 🔗 Connect:

7. Click the "Connect" button to establish a connection with the device.
8. On successful connection, the status label will display "Connected" in green.

📝 Commands

Interact with your device using predefined command buttons:

• ⚡ Start Deauther: Initiates the deauthentication attack cycle.
• ⏹️ Stop Deauther: Halts the deauthentication attack cycle.
• 🔍 Scan: Conducts a WiFi scan to detect available networks.
• 📄 Results: Retrieves and displays the latest scan results.
• 🛑 Disassoc: Begins continuous disassociation attacks.
• 🎲 Random Attack: Performs a random attack on a selected AP.
• ⏱️ Attack Time: Starts a timed attack.
• 👁️ Start Sniff: Enables the sniffer with ALL mode.
• 🔍 Sniff Beacon: Toggles beacon capture.
• 📡 Sniff Probe: Toggles probe requests/responses.
• ⚡ Sniff Deauth: Toggles deauth/disassoc frames.
• 🔑 Sniff EAPOL: Toggles EAPOL frames.
• 🤖 Sniff Pwnagotchi: Toggles Pwnagotchi beacons.
• 👀 Sniff All: Toggles all frames.
• ⏹️ Stop Sniff: Stops sniffing.
• 🔄 Hop On: Enables channel hopping.
• ⏸️ Hop Off: Disables channel hopping.
• ℹ️ Info: Shows the current configuration of the device.
• ❓ Help: Lists available commands and their descriptions.

⚙️ Setting Parameters

Customize device parameters in the "Set Parameters" section:

• ⏱️ Cycle Delay (ms): Time delay between scan/deauthentication cycles.
• ⏲️ Scan Time (ms): Duration of each WiFi scan.
• 📊 Num Frames: Number of deauthentication frames sent per AP.
• 📡 Start Channel: Starting channel for scanning (e.g., 1 for 2.4GHz or 36 for 5GHz).
• 🔄 Scan Between Cycles: Toggle scanning between attack cycles (on or off).
• 💡 LEDs: Control the device LEDs (on or off).
• 🔄 Hop Interval (ms): Time interval for channel hopping.
• 🔍 Sniff Mode: Select the sniffing mode (e.g., beacon, probe, deauth, eapol, pwnagotchi, all).
• 📡 Channel Band: Select the channel band (e.g., 2.4GHz, 5GHz).

Click the "Apply" button to send the configured parameters to the device.

🎯 Targeting APs

Focus your attacks on specific APs in the "Target APs" section:

1. 🔢 Enter Target Indices:

2. Input comma-separated indices corresponding to the APs listed in the scan results (e.g., 1,3,5).

3. 🎯 Set Target:

4. Click the "Set Target" button to configure the device to target the specified APs.

🛠️ Custom Commands

Experiment with advanced features using the "Custom Command" section:

1. ✏️ Enter Command:

2. Type any arbitrary command in the "Command" entry field.

3. 🚀 Send Command:

4. Click the "Send" button to transmit the custom command to the device.

⚠️ Note: Use this feature with caution. Sending unknown or malformed commands may disrupt device functionality.

🔘 System Tray

Manage the application conveniently via the system tray icon:

• 🔽 Minimize to Tray:

• Click the "X" button to hide the main window in the system tray.

• 🔄 Tray Menu:

• Show: Restore the main application window.
• Quit: Exit the application completely.

All tray and window icons utilize the icon.ico file for a consistent look and feel.

📄 License

This project is licensed under the MIT License.

🤝 Contributing

We welcome contributions! Follow these steps to contribute:

1. 🍴 Fork the Repository

2. 🌿 Create a Feature Branch

bash git checkout -b feature/YourFeature

1. 💾 Commit Your Changes

bash git commit -m "Add some feature"

1. 📤 Push to the Branch

bash git push origin feature/YourFeature

1. 🔀 Open a Pull Request

Please ensure your code adheres to the project's coding standards and includes appropriate documentation.

Credits

• Developers:
• 7h30th3r0n3
• dagnazty
• Hosseios

---

🔒 Stay Ethical. Use Responsibly.