wifi-audit-tool

KO | EN

gitlite — search

#javascript #go #golang #android #rust #docker #java #windows #cli #kubernetes #vue #security #ios #openai

wifi-audit-tool

(★ 63)

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.

wifi-audit-tool Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# WiFi Audit Tool — Command Line Wireless Security Toolkit

<br>

</p>

---

## 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

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

### Make Installer Executable

```bash
chmod +x install.sh
```

### Install Dependencies

```bash
./install.sh
```

---

## Usage

Run with root privileges:

```bash
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](https://github.com/trmxvibs)
### YouTube: [Lokesh-Kumar](https://youtube.com/@termux2)

### Contributions

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

---

wifi-audit-tool

wifi-audit-tool Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

wifi-audit-tool

wifi-audit-tool Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README