Metadata-Version: 2.4
Name: Wi-Fi-Attack
Version: 4.0.1
Summary: Wi-Fi attack toolkit for penetration testing (educational use only)
Home-page: https://github.com/cyb2rS2c/Wi-Fi_ATTACK
Author: cyb2rS2c
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: colorama
Requires-Dist: termcolor
Requires-Dist: pyfiglet
Requires-Dist: tabulate
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Wi-Fi Attack Automation Tool
![Python](https://img.shields.io/badge/Python-3.8%2B-blue?logo=python)
![Platform](https://img.shields.io/badge/%7C%20Linux-green?logo=linux)
![License](https://img.shields.io/badge/License-MIT-yellow)
![Version](https://img.shields.io/badge/Version-4.0-orange)

---
This tool is a Python-based utility that automates the process of Wi-Fi network penetration testing, including handshake capture, password cracking, DoS attacks, and password list generation. It acts as a wrapper around powerful tools like `aircrack-ng`, `airodump-ng`, `aireplay-ng`, `crunch`, and `wireshark`.

**For Authorized Penetration Testing Only**
This tool is intended for security professionals and researchers on networks they own or are authorized to audit. Unauthorized access or attacks on networks are illegal and unethical.

---

## Features

* Scan for Access Points and capture detailed information.
* Detect and lock on target network channels.
* Capture WPA/WPA2 handshakes.
* Launch deauthentication (DoS) attacks.
* Crack captured handshakes using a wordlist or custom-generated passwords.
* Generate password lists with custom masks using `crunch`.
* Launch Wireshark for EAPOL packet inspection.
* Interactive terminal-based menu interface.

---


## Project Tree
```
├── assets (All password files created should be in this folder)
│   ├── generated_password.txt
│   └── john.lst
├── LICENSE
├── README.md
├── requirements.txt
├── setup.sh
└── src
    ├── animation.py
    ├── GenCharlist.py
    ├── Get_AP.py
    ├── mac_address_detector.py
    ├── network_scanner.py
    └── wifi_cracker.py
```

##  Usage

### 1. Clone the Repository

```bash
git clone https://github.com/cyb2rS2c/Wi-Fi_ATTACK.git
cd Wi-Fi_ATTACK
```

## 2. Run 

```bash
chmod +x setup.sh;source ./setup.sh
```
Root privileges are required for most network interface operations.

## Screenshots
<img width="598" height="182" alt="image" src="https://github.com/user-attachments/assets/0309f637-0fc0-48d7-9d52-fecce0bbf7aa" />
<img width="621" height="250" alt="image" src="https://github.com/user-attachments/assets/b6891c9c-be70-468a-9757-b6efbfbf98a4" />
<img width="956" height="609" alt="image" src="https://github.com/user-attachments/assets/9248abd5-f035-4726-ac08-8aba8d8b7f00" />


## Legal Disclaimer

This software is provided for **educational** and **authorized pentesting** only. The author is not responsible for any misuse or damage caused. Always get **explicit permission** before auditing any network.

---

## Author
cyb2rS2c - [GitHub Profile](https://github.com/cyb2rS2c)

## License

MIT License. See [LICENSE](https://github.com/cyb2rS2c/Wi-Fi_ATTACK/blob/main/LICENSE) for more info.

