{"id":23537760,"url":"https://github.com/dagnazty/evil-bw16-control-panel","last_synced_at":"2025-04-23T14:14:47.625Z","repository":{"id":269110930,"uuid":"906459526","full_name":"dagnazty/Evil-BW16-Control-Panel","owner":"dagnazty","description":"A sleek and intuitive GUI built with Tkinter for managing the Evil-BW16 device, designed for ethical WiFi network testing and penetration testing.","archived":false,"fork":false,"pushed_at":"2025-04-23T13:18:39.000Z","size":337,"stargazers_count":20,"open_issues_count":0,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T14:14:47.086Z","etag":null,"topics":["bw16","evil-bw16","gui","python"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dagnazty.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-12-21T00:55:35.000Z","updated_at":"2025-04-23T13:18:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"1b99f74e-e27b-439f-8e6d-cf567c3f26f7","html_url":"https://github.com/dagnazty/Evil-BW16-Control-Panel","commit_stats":null,"previous_names":["dagnazty/evil-bw16-control-panel"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dagnazty%2FEvil-BW16-Control-Panel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dagnazty%2FEvil-BW16-Control-Panel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dagnazty%2FEvil-BW16-Control-Panel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dagnazty%2FEvil-BW16-Control-Panel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dagnazty","download_url":"https://codeload.github.com/dagnazty/Evil-BW16-Control-Panel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250447979,"owners_count":21432165,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bw16","evil-bw16","gui","python"],"created_at":"2024-12-26T03:19:16.612Z","updated_at":"2025-04-23T14:14:47.617Z","avatar_url":"https://github.com/dagnazty.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg) ![GitHub issues](https://img.shields.io/github/issues/dagnazty/Evil-BW16-Control-Panel) ![GitHub stars](https://img.shields.io/github/stars/dagnazty/Evil-BW16-Control-Panel?style=social) ![GitHub forks](https://img.shields.io/github/forks/dagnazty/Evil-BW16-Control-Panel?style=social)\n\n# 🎛️ Evil-BW16 Control Panel\n\n![Evil-BW16 Logo](logo.png)\n\n\u003c/div\u003e\n\n**⚠️ Disclaimer:**  \n\n\u003cdiv align=\"center\"\u003e\n\n[Evil-BW16](https://github.com/7h30th3r0n3/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.\n\n---\n\n\u003c/div\u003e\n\n## 📖 Table of Contents\n\n- [✨ Introduction](#-introduction)\n- [🚀 Features](#-features)\n- [🛠️ Requirements](#️-requirements)\n  - [💻 Software](#-software)\n  - [🔧 Hardware](#-hardware)\n- [📦 Installation](#-installation)\n- [🎯 Usage](#-usage)\n  - [🔌 Connecting to the Device](#-connecting-to-the-device)\n  - [📝 Commands](#-commands)\n  - [⚙️ Setting Parameters](#-setting-parameters)\n  - [🎯 Targeting APs](#-targeting-aps)\n  - [🛠️ Custom Commands](#-custom-commands)\n  - [🔘 System Tray](#-system-tray)\n- [📄 License](#-license)\n- [🤝 Contributing](#-contributing)\n- [📬 Contact](#-contact)\n- [Credits](#-credits)\n\n---\n\n## ✨ Introduction\n\n\u003cdiv align=\"center\"\u003e\n\nWelcome 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:\n\n\u003c/div\u003e\n\n- **Scan** for WiFi networks\n- **Send deauthentication frames**\n- **Target specific access points (APs)**\n\n\u003cdiv align=\"center\"\u003e\n  \nWhether you're a cybersecurity enthusiast or a professional tester, our control panel simplifies complex operations, making your ethical hacking endeavors both efficient and effective.\n\n\u003c/div\u003e\n\n## 🚀 Features\n\n- **🔌 Serial Port Management:**\n  - Seamlessly connect/disconnect from serial ports.\n  - Dynamically refresh available serial ports.\n\n- **📝 Command Execution:**\n  - 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`.\n  - Send custom commands for experimental features.\n\n- **⚙️ Parameter Configuration:**\n  - Configure settings like cycle delay, scan time, number of frames, start channel, scan cycles, LED control, hop interval, sniff mode, and channel band.\n  - Apply multiple parameters simultaneously with ease.\n\n- **Debug and Help:**\n  - Toggle debug mode for detailed device diagnostics.\n  - Access comprehensive help documentation through the help window.\n\n- **🎯 Targeting APs:**\n  - Specify target AP indices to focus deauthentication attacks on selected networks.\n\n- **🔘 System Tray Integration:**\n  - Minimize the application to the system tray.\n  - Easily restore or quit the application from the tray icon.\n\n- **📜 Device Output Logging:**\n  - Real-time display of device responses and logs for comprehensive monitoring.\n\n## 🛠️ Requirements\n\n### 💻 Software\n\n- **Python 3.6 or Higher**\n- **Libraries:**\n  - `customtkinter`\n  - `pystray`\n  - `Pillow`\n  - `pyserial`\n\n#### 📥 Installation of Python Libraries\n\nInstall the necessary Python libraries using `pip`:\n\n```bash\npip install customtkinter pystray Pillow pyserial\n```\n\n### 🔧 Hardware\n\n- **🖥️ Evil-BW16 Device:** Ensure your Evil-BW16 hardware is properly connected to your computer via a serial connection (e.g., USB).\n- **🖼️ 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.\n\n## 📦 Installation\n\n1. **🔍 Clone the Repository:**\n\n   ```bash\n   git clone https://github.com/dagnazty/Evil-BW16-Control-Panel.git\n   cd Evil-BW16-Control-Panel\n   ```\n\n2. **📦 Install Dependencies:**\n\n   Ensure all required Python libraries are installed as outlined in the [Requirements](#️-requirements) section.\n\n3. **🖼️ Prepare the Icon:**\n\n   Make sure you have an `icon.ico` file in the project directory. This icon will represent both the application window and the system tray.\n\n## 🎯 Usage\n\nLaunch the Evil-BW16 Control Panel with Python:\n\n```bash\npython evil_bw16_gui.py\n```\n\n### 🔌 Connecting to the Device\n\n1. **📡 Select Serial Port:**\n   - Choose the appropriate COM port from the \"Serial Port\" dropdown connected to your Evil-BW16 device.\n   - Click the \"Refresh\" button to update the list of available ports.\n\n2. **🔢 Select Baud Rate:**\n   - Select the desired baud rate from the \"Baud Rate\" dropdown. The default is `115200`.\n\n3. **🔗 Connect:**\n   - Click the \"Connect\" button to establish a connection with the device.\n   - On successful connection, the status label will display \"Connected\" in green.\n\n### 📝 Commands\n\nInteract with your device using predefined command buttons:\n\n- **⚡ Start Deauther:** Initiates the deauthentication attack cycle.\n- **⏹️ Stop Deauther:** Halts the deauthentication attack cycle.\n- **🔍 Scan:** Conducts a WiFi scan to detect available networks.\n- **📄 Results:** Retrieves and displays the latest scan results.\n- **🛑 Disassoc:** Begins continuous disassociation attacks.\n- **🎲 Random Attack:** Performs a random attack on a selected AP.\n- **⏱️ Attack Time:** Starts a timed attack.\n- **👁️ Start Sniff:** Enables the sniffer with ALL mode.\n- **🔍 Sniff Beacon:** Toggles beacon capture.\n- **📡 Sniff Probe:** Toggles probe requests/responses.\n- **⚡ Sniff Deauth:** Toggles deauth/disassoc frames.\n- **🔑 Sniff EAPOL:** Toggles EAPOL frames.\n- **🤖 Sniff Pwnagotchi:** Toggles Pwnagotchi beacons.\n- **👀 Sniff All:** Toggles all frames.\n- **⏹️ Stop Sniff:** Stops sniffing.\n- **🔄 Hop On:** Enables channel hopping.\n- **⏸️ Hop Off:** Disables channel hopping.\n- **ℹ️ Info:** Shows the current configuration of the device.\n- **❓ Help:** Lists available commands and their descriptions.\n\n### ⚙️ Setting Parameters\n\nCustomize device parameters in the \"Set Parameters\" section:\n\n- **⏱️ Cycle Delay (ms):** Time delay between scan/deauthentication cycles.\n- **⏲️ Scan Time (ms):** Duration of each WiFi scan.\n- **📊 Num Frames:** Number of deauthentication frames sent per AP.\n- **📡 Start Channel:** Starting channel for scanning (e.g., `1` for 2.4GHz or `36` for 5GHz).\n- **🔄 Scan Between Cycles:** Toggle scanning between attack cycles (`on` or `off`).\n- **💡 LEDs:** Control the device LEDs (`on` or `off`).\n- **🔄 Hop Interval (ms):** Time interval for channel hopping.\n- **🔍 Sniff Mode:** Select the sniffing mode (e.g., `beacon`, `probe`, `deauth`, `eapol`, `pwnagotchi`, `all`).\n- **📡 Channel Band:** Select the channel band (e.g., `2.4GHz`, `5GHz`).\n\nClick the **\"Apply\"** button to send the configured parameters to the device.\n\n### 🎯 Targeting APs\n\nFocus your attacks on specific APs in the \"Target APs\" section:\n\n1. **🔢 Enter Target Indices:**\n   - Input comma-separated indices corresponding to the APs listed in the scan results (e.g., `1,3,5`).\n\n2. **🎯 Set Target:**\n   - Click the **\"Set Target\"** button to configure the device to target the specified APs.\n\n### 🛠️ Custom Commands\n\nExperiment with advanced features using the \"Custom Command\" section:\n\n1. **✏️ Enter Command:**\n   - Type any arbitrary command in the \"Command\" entry field.\n\n2. **🚀 Send Command:**\n   - Click the **\"Send\"** button to transmit the custom command to the device.\n\n**⚠️ Note:** Use this feature with caution. Sending unknown or malformed commands may disrupt device functionality.\n\n### 🔘 System Tray\n\nManage the application conveniently via the system tray icon:\n\n- **🔽 Minimize to Tray:**\n  - Click the \"X\" button to hide the main window in the system tray.\n\n- **🔄 Tray Menu:**\n  - **Show:** Restore the main application window.\n  - **Quit:** Exit the application completely.\n\n_All tray and window icons utilize the `icon.ico` file for a consistent look and feel._\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n## 🤝 Contributing\n\nWe welcome contributions! Follow these steps to contribute:\n\n1. **🍴 Fork the Repository**\n\n2. **🌿 Create a Feature Branch**\n\n   ```bash\n   git checkout -b feature/YourFeature\n   ```\n\n3. **💾 Commit Your Changes**\n\n   ```bash\n   git commit -m \"Add some feature\"\n   ```\n\n4. **📤 Push to the Branch**\n\n   ```bash\n   git push origin feature/YourFeature\n   ```\n\n5. **🔀 Open a Pull Request**\n\n\u003cdiv align=\"center\"\u003e\n\nPlease ensure your code adheres to the project's coding standards and includes appropriate documentation.\n\n\u003c/div\u003e\n\n## Credits\n\n- **Developers:**\n  - [7h30th3r0n3](https://github.com/7h30th3r0n3)\n  - [dagnazty](https://github.com/dagnazty)\n  - [Hosseios](https://github.com/Hosseios)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n\n**🔒 Stay Ethical. Use Responsibly.**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdagnazty%2Fevil-bw16-control-panel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdagnazty%2Fevil-bw16-control-panel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdagnazty%2Fevil-bw16-control-panel/lists"}