WIFX

Wireless Assessment — Wi-Fi discovery, capture workflow support, and reporting for authorized labs.

---

Overview

WIFX is a wireless assessment helper for authorized lab environments.

It focuses on interface checks, monitor mode assistance, network discovery, capture workflow organization, and reporting.

Commands that may affect networks require explicit --authorized.

---

Features

• Wireless interface discovery.
• Monitor mode helper.
• Nearby network listing.
• Capture workflow helper.
• WPS status checks.
• Report directory creation.
• Clear safety gates for sensitive actions.

---

Installation

git clone https://github.com/NeiveZ/Wireless-Assessment.git
cd Wireless-Assessment
chmod +x wifx.sh
./wifx.sh --install

Common Kali dependencies:

sudo apt update
sudo apt install aircrack-ng wireless-tools iw -y

Validate:

./wifx.sh --check

---

Usage

./wifx.sh <command> [options]

Help:

./wifx.sh --help

---

Commands

List wireless interfaces

./wifx.sh interfaces

Check environment

./wifx.sh check

Start monitor mode

./wifx.sh monitor --iface wlan0 --authorized

Scan nearby networks

./wifx.sh scan --iface wlan0mon --authorized

Capture workflow

./wifx.sh capture --iface wlan0mon --bssid AA:BB:CC:DD:EE:FF --channel 6 --out captures/lab --authorized

WPS check

./wifx.sh wps --iface wlan0mon --authorized

---

Recommended Procedure

1. Identify interfaces:

./wifx.sh interfaces

2. Enable monitor mode in a lab:

./wifx.sh monitor --iface wlan0 --authorized

3. Scan networks:

./wifx.sh scan --iface wlan0mon --authorized

4. Save evidence:

./wifx.sh capture --iface wlan0mon --bssid <BSSID> --channel <CH> --out captures/lab --authorized

5. Restore interface after testing.

---

Safety

Use WIFX only in labs or networks you own/have written authorization to test. Do not disrupt third-party wireless networks.

---

License

MIT License.