Skip to content

trmxvibs/wifi-audit-tool

Repository files navigation

WiFi Audit Tool — Command Line Wireless Security Toolkit



Overview

WiFi Audit Tool is a command-line wireless security toolkit built for Kali Linux environments. It is designed to streamline authorized wireless network assessments through an interactive menu-driven workflow.

The tool automates common audit steps such as enabling monitor mode, scanning nearby networks, and preparing WPA/WPA2 handshake capture sessions using standard aircrack-ng utilities.


Authorization Requirement

This tool is intended strictly for authorized security testing.

Running scans or capture operations against networks without explicit written permission may violate laws and regulations. The author and contributors are not responsible for misuse or resulting damage.

Allowed use cases:

  • Networks you own
  • Networks you are contracted to test
  • Controlled lab environments

Core Features

Automatically enables and disables monitor mode on the selected wireless adapter.

Discovers nearby wireless networks using airodump-ng.

Targets a selected BSSID and channel to capture WPA/WPA2 handshakes.

Generates ready-to-run cracking commands for offline analysis tools.


Dependencies

Required components:

  • Python 3.8 or higher
  • aircrack-ng suite
  • airodump-ng
  • iw
  • iproute2
  • Kali Linux or compatible distribution

Installation

Clone Repository

git clone https://github.com/trmxvibs/wifi-audit-tool.git
cd wifi-audit-tool

Make Installer Executable

chmod +x install.sh

Install Dependencies

./install.sh

Usage

Run with root privileges:

sudo python3 wifi_audit.py

An interactive menu will guide adapter selection, scanning, and capture setup.


Example Authorized Audit Workflow

Typical permitted lab workflow:

  1. Select wireless adapter
  2. Enable monitor mode
  3. Scan nearby access points
  4. Choose target BSSID and channel
  5. Start capture session
  6. Verify handshake capture
  7. Perform offline password audit using external tools

Example: testing your own lab router to verify password strength and capture reliability.


Common Error: No Interfaces Detected

Error:

Error detecting interfaces: Command ['iw', 'dev'] returned non-zero exit status 1

Cause

Occurs when running Kali inside Android/Termux or NetHunter guest mode. The host OS blocks direct access to the internal WiFi chipset.

Fix

Use external hardware.


Required Hardware

You need:

  • OTG adapter
  • External USB WiFi adapter
  • Monitor mode supported chipset

Supported chipsets:

  • Atheros AR9271
  • Ralink RT5370

Recommended Environment

Best reliability:

  • Native Kali Linux
  • Kali Live USB
  • Kali VM with USB passthrough
  • Dedicated test adapter


Author

Independent security enthusiast focused on wireless security testing, Kali Linux tooling, and practical command-line automation.

Contact

GitHub: Lokesh-Kumar

YouTube: Lokesh-Kumar

Contributions

Pull requests, issue reports, and security improvement suggestions are welcome.
For major changes, open an issue first to discuss the proposal.


About

A user-friendly command-line toolkit for WiFi network scanning, handshake capture, and vulnerability reporting—compatible with Termux (Android), Kali Linux, and WSL. For ethical hacking, learning, and authorized penetration testing only.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages