Metadata-Version: 2.4
Name: atwa
Version: 2.7.2
Summary: ATWA-NG: native WiFi security auditing engine with vendored scanning/cracking binaries, self-contained
Author-email: KiMiGuel <contact@indepentest.pro>
License: MIT
Project-URL: Homepage, https://indepentest.pro
Project-URL: Repository, https://github.com/KiMiGuel/ATWA-NG
Project-URL: Issues, https://github.com/KiMiGuel/ATWA-NG/issues
Keywords: wifi,security,auditing,pentest,wireless,802.11
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: X11 Applications
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: scapy>=2.5
Requires-Dist: cryptography>=42
Requires-Dist: pycryptodome>=3.20
Requires-Dist: dpkt>=1.9.8
Requires-Dist: ttkthemes>=3.2
Provides-Extra: dev
Requires-Dist: ruff>=0.15; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: pyflakes>=3.2; extra == "dev"
Dynamic: license-file

# ATWA-NG

WiFi auditing tool — scan, capture and crack WPA/WEP, plus flood, rogue-AP and WPS attacks.

**Requires root.** Authorized testing only.

## Install

```bash
git clone https://github.com/KiMiGuel/ATWA-NG
cd ATWA-NG && pip install -e .
```

## Usage

Full (concise) guide: [`docs/usage.md`](docs/usage.md).

## Quick start

```bash
sudo atwa gui
sudo atwa injection-test
sudo atwa scan --iface wlan0
sudo atwa omni --iface wlan0 --bssid AA:BB:CC:DD:EE:FF --ssid NET
sudo atwa crack ~/atwa-hs/NET_AA:BB:CC:DD:EE:FF/handshake-01.cap
```

## Commands

| | |
|---|---|
| `scan` | channel-hopping AP/client scan |
| `injection-test` | injection self-test |
| `wps-recon` | WPS-enabled AP recon |
| `eapol-hunt` | passive EAPOL handshake capture |
| `verify-handshake` | verify a captured handshake |
| `handshake` | 4-way handshake capture |
| `pmkid` | clientless PMKID capture |
| `crack-cap` | crack a capture directly |
| `crack` | crack a 22000/cap file |
| `deauth` | deauth flood |
| `chaos` | coordinated multi-vector flood |
| `omni` | adaptive chain: pmkid → handshake → crack |
| `smart` | pmkid → deauth + handshake |
| `wep` / `wep-hirte` | fake-auth + ARP replay + PTW |
| `wps-pixie` | Pixie-Dust |
| `wps-oneshot` | WPS via `wpa_supplicant` |
| `downgrade-twin` / `owe-downgrade` / `pmf-bypass` | rogue-AP downgrade |
| `dragonblood` | SAE timing side-channel pruning |
| `gui` | desktop GUI |
| `update` | install a newer release |

## Configuration

No config file. Fixed conventions:

- **Captures** → `~/atwa-hs/<SSID>_<BSSID>/`
- **Global flags** → `--help`, `--version`
- **Per-command** → `atwa <command> --help`

## Contribute

`CONTRIBUTING.md` — commit format, branches, PR rules.

Gates: `ruff check src/`, `mypy src/`, `pytest`.

## License

MIT
