Metadata-Version: 2.4
Name: wifilab
Version: 1.2.0
Summary: Wi-Fi Lab Controller: Safe WiFi testing toolkit with scanning, fake AP, DNS redirection.
Home-page: https://github.com/ZahidServers/WiFi-Lab-Controller
Author: Mohammed Zahid Wadiwale
Author-email: info@webaon.com
License: BSD-3-Clause
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: POSIX :: Linux
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

# WiFi-Lab-Controller

[![PyPI version](https://img.shields.io/pypi/v/wifilab.svg)](https://pypi.org/project/wifilab/)
[![Python versions](https://img.shields.io/pypi/pyversions/wifilab.svg)](https://pypi.org/project/wifilab/)
[![License](https://img.shields.io/pypi/l/wifilab.svg)](https://github.com/ZahidServers/WiFi-Lab-Controller/blob/main/LICENSE)
[![Tests](https://github.com/ZahidServers/WiFi-Lab-Controller/actions/workflows/python-package.yml/badge.svg)](https://github.com/ZahidServers/WiFi-Lab-Controller/actions)
[![Documentation Status](https://readthedocs.org/projects/wifi-lab-controller/badge/?version=latest)](https://wifi-lab-controller.readthedocs.io/en/latest/)

---

# 📘 **Wi-Fi Lab Controller — User Manual & README**
It includes:

* ✅ README
* ✅ Installation Guide
* ✅ Features List
* ✅ Usage Manual (per tab)
* ✅ Legal & Safety Notes
* ✅ Requirements
* ✅ Troubleshooting
* ✅ Author & Credits

A GUI‑based Wi‑Fi learning and testing toolkit created by
**Mohammed Zahid Wadiwale**
🌐 [https://www.webaon.com](https://www.webaon.com)

---

# 📌 **What Is Wi‑Fi Lab Controller?**

Wi‑Fi Lab Controller is an **educational GUI toolkit** that allows you to experiment with Wi‑Fi functions **safely on your own equipment**.

It is made for:

* Raspberry Pi
* Parrot OS
* Kali Linux
* Ubuntu (with wireless tools installed)
* Any Linux system with **aircrack‑ng**, **hostapd**, **dnsmasq**, and **NetworkManager**

❗ **This tool is strictly for lab experiments on your own Wi‑Fi network.**

It does **NOT** include any malicious intent — all functions require manual confirmation and can be restored with the *End Attack / Restore Normal* button.

---

# 📥 **Installation**

Install required dependencies:

```bash
sudo apt update
sudo apt install python3 python3-tk aircrack-ng hostapd dnsmasq network-manager xdg-utils
```

Clone your repository:

```bash
git clone https://github.com/ZahidServers/WiFi-Lab-Controller.git
cd Wifi-Lab-Controller
cd wifilab
```

Run:

```bash
sudo python3 app.py
```

(root or sudo required)

## 📥 Installation (Linux / Parrot / Kali / Debian / Ubuntu / Raspberry Pi OS) via PyiPi

### 🔧 Required System Packages

```bash
sudo apt update
sudo apt install -y python3 python3-tk aircrack-ng hostapd dnsmasq network-manager xdg-utils
```

---

## 🐍 Install from PyPI (Recommended)

```bash
pip install wifilab
```

### ⚠️ Note for Debian/Kali/Parrot/Raspberry Pi OS

If you see:

```
error: externally-managed-environment
```

Use pipx or a virtual environment:

---

### ▶️ Option 1 — Using pipx (Best)

```bash
sudo apt install pipx
pipx ensurepath
pipx install wifilab
wifilab
```

---

### ▶️ Option 2 — Using Virtual Environment

```bash
python3 -m venv venv
source venv/bin/activate
pip install wifilab
python -m wifilab
```

---

### ⚠️ Not Recommended

```bash
pip install wifilab --break-system-packages
```

---

## 🚀 Running

```bash
wifilab
```

or

```bash
python -m wifilab
```

---

# 🧰 **Features Overview**

| Feature                                | Description                                |
| -------------------------------------- | ------------------------------------------ |
| **Mode 1 — Safe Disconnect + Fake AP** | Restarts Wi‑Fi + starts your test AP       |
| **Mode 2 — Fake AP Only**              | Runs hostapd & dnsmasq                     |
| **Mode 3 — Scan 2.4 GHz**              | Monitor mode + airodump scan + DeAuth      |
| **Mode 4 — Scan 5 GHz**                | Monitor mode + airodump scan + DeAuth      |
| **Network Table**                      | Shows BSSID, Channel, Band, ESSID          |
| **Click-to-Select Networks**           | User must confirm selection                |
| **Automated Restore System**           | Stops AP, clears dnsmasq, flushes iptables |
| **Domain Redirection**                 | Add dnsmasq rules easily                   |
| **NAT Routing**                        | Enable local routing for fake AP           |
| **About Tab**                          | Credits, website links, support info       |

---

# 📘 **Using Wi‑Fi Lab Controller (Tabs Explained)**

---

## 🏠 **1. Home Tab**
![Home Tab](https://raw.githubusercontent.com/ZahidServers/WiFi-Lab-Controller/refs/heads/main/Screenshot1.png)
### **Mode 1: Safe Disconnect + Fake AP**

* Restarts Wi‑Fi interface
* Starts your configured hostapd fake AP
* Starts dnsmasq DHCP

### **Mode 2: Fake AP Only**

Starts hostapd + dnsmasq without restarting Wi‑Fi.

### **Safe Disconnect**

Equivalent to:

```bash
ip link set wlan0 down
sleep 2
ip link set wlan0 up
```

### **Start Duplicate AP**

Starts hostapd & dnsmasq.

### **Stop Fake AP**

Stops hostapd & dnsmasq.

### **End Attack / Restore Normal**

Restores EVERYTHING to default:

✔ Stops fake AP
✔ Stops dnsmasq
✔ Clears dnsmasq.conf
✔ Flushes iptables
✔ Restarts Wi‑Fi
✔ Restarts NetworkManager

**If anything breaks, this button fixes it.**

---

## 🌐 **2. Network Tab**
![Network Tab](https://raw.githubusercontent.com/ZahidServers/WiFi-Lab-Controller/refs/heads/main/Screenshot4.png)
### **Show Network Interfaces**

Runs:

```bash
ip a
```

### **Enable NAT Routing**

Adds a MASQUERADE rule for sharing internet:

```bash
iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
```

---

## 🧭 **3. Domain Redirection Tab**
![Domain Tab](https://raw.githubusercontent.com/ZahidServers/WiFi-Lab-Controller/refs/heads/main/Screenshot3.png)
Used for local DNS experiments.

You can add:

```
address=/example.com/192.168.1.10
```

Useful for:

* Phishing lab practice (on *your own machines only*)
* Local DNS tests
* Redirecting domains to internal servers

After adding a rule, dnsmasq restarts automatically.

---

## 📡 **4. Scan Networks (Mode 3 & 4)**
![Scan Tab](https://raw.githubusercontent.com/ZahidServers/WiFi-Lab-Controller/refs/heads/main/Screenshot2.png)
### Requirements

Your Wi‑Fi card must support:

* Monitor Mode
* Packet injection

(usb cards: Alfa, TP‑Link T2U, T9UH, AC600, etc.)

### **Modes**

| Mode       | Function                |
| ---------- | ----------------------- |
| **Mode 3** | Scans 2.4 GHz (bg band) |
| **Mode 4** | Scans 5 GHz (a band)    |

### How Scanning Works

* Puts interface into monitor mode via **airmon-ng**
* Runs **airodump‑ng**
* Reads output CSV in live mode
* Updates table automatically every 2 seconds
* Auto‑stops after 10 seconds unless manually stopped

### Click‑to‑Select Network

When you click a row:

A CONFIRM BOX appears:

```
Do you want to select this network?

Interface: wlan0
BSSID: XX:XX:XX:XX
Channel: 6
Band: 2.4
ESSID: MyWifi
```

If user clicks **OK**:

* Channel is set
* (Optional/Disable) deauth function runs if enabled

If user clicks **Cancel**:

* Nothing happens

---

## ℹ️ **5. About Tab**
![About Tab](https://raw.githubusercontent.com/ZahidServers/WiFi-Lab-Controller/refs/heads/main/about.png)
Contains:

* App description
* Author info
* Website links
* GitHub
* Blog
* Academy
* Support information
* Copyright

---

# ❗ Legal & Safety Notice

This toolkit is for **EDUCATIONAL & LAB USE ONLY**.

You MUST:

✔ Only test on your own Wi‑Fi
✔ Not use on public Wi‑Fi
✔ Not test on neighbors, hotels, offices, or any unauthorized network

The tool includes features that demonstrate how Wi-Fi attacks work — **they are meant for cybersecurity learning only**.

---

# 🛠 **Requirements**

* Linux OS
* Python 3
* Python tkinter
* aircrack-ng
* hostapd
* dnsmasq
* xdg-utils
* Wireless card supporting monitor mode / AP mode

---

# 🐞 Troubleshooting

### **Problem: "Cannot find device wlan0"**

Solutions:

* Replace with your interface name (use `ip a`)
* Many systems use `wlp3s0`, `wlan1`, etc.

### **Monitor Mode Not Starting**

* Use compatible wireless adapter
* Try:

  ```bash
  sudo airmon-ng check kill
  ```

### **Fake AP not starting**

Check hostapd.conf and dnsmasq.conf syntax.

### **Network breaks**

Click **End Attack / Restore Normal**.

---

# 👨‍💻 Author

**Developed by:**
#### 👉 **Mohammed Zahid Wadiwale**

* 🌐 Website — [https://www.webaon.com](https://www.webaon.com)
* 💻 GitHub — [https://github.com/ZahidServers](https://github.com/ZahidServers)
* 📰 Blog — [https://blog.webaon.com](https://blog.webaon.com)
* 🎓 Academy — [https://academy.webaon.com](https://academy.webaon.com)

#### Support development by buying:

* Hosting
* Domains
* Websites
* Cybersecurity services
* Courses

---
