---

📖 Introduction

ActiveVPN is a powerful, cross-platform terminal utility designed to verify your digital privacy status. Whether you are a privacy enthusiast, a sysadmin, or just a casual user, knowing if your VPN is actually working is crucial.

Unlike simple "What is my IP" websites, ActiveVPN dives deeper. It inspects your system's network interfaces, analyzes running processes, checks your external IP against known hosting providers, and performs DNS leak tests—all presented in a beautiful, hacker-style TUI (Terminal User Interface).

🚀 How It Works

ActiveVPN operates on three distinct layers to ensure accuracy:

1. System Layer Inspection 💻

   • It scans your operating system (Linux, Windows, macOS, Android/Termux) for network interfaces commonly used by VPN protocols (e.g., tun0, wg0, ppp).
   • It checks for active processes associated with VPN providers (e.g., openvpn, wireguard, nordvpn, tor).

2. External IP Analysis 🌍

   • It queries external APIs to fetch your Public IP.
   • It analyzes the ISP (Internet Service Provider) name. If the ISP is a known Data Center (e.g., DigitalOcean, M247), it flags the connection as "LIKELY VPN/PROXY".

3. DNS Leak Detection 🕵️‍♂️

   • It compares your Public IP with the IP address resolving your DNS queries. If they are different, it warns you, helping you identify potential DNS leaks where your ISP might still see your requests.

✨ Features

• 🖥️ Beautiful TUI: Built with the rich library for a modern, colorful, and easy-to-read terminal interface.
• 🐧 Cross-Platform: Works seamlessly on Linux, macOS, Windows, and Android (via Termux).
• 🔎 Deep Scan: Detects VPNs via Interface names, Process names, and IP reputation.
• 🧅 Tor Detection: Specifically checks for active Tor services.
• ☠️ Kill Switch: Built-in command to terminate running VPN processes instantly (with a --kill-force fallback).
• 📝 History Logging: Automatically saves scan results to .scan_history.json for your records.
• 🚨 DNS Consistency: Verifies if your DNS requests are being tunneled correctly.
• 🌍 IPv6 Leak Check: Reports your external IPv6 address and warns if IPv6 could leak alongside a VPN tunnel.
• 🏷️ Overall Verdict: Combines every signal into a single confidence score and verdict (CLEAN / SUSPICIOUS / LIKELY VPN / VPN DETECTED).
• 🔁 Watch Mode: Continuously re-scans your network at a configurable interval.
• 📤 History Export: Export past scans as JSON, CSV, or plain text.
• ⚙️ Config File: Override patterns, colors, and API URLs without touching the code.

📂 Project Structure

Here is how ActiveVPN is organized:

vpnActive/
├── main.py               # 🚀 Entry point: The script you run to start the tool
├── config.py             # ⚙️ Configuration: Settings, API URLs, and Colors
├── requirements.txt      # 📦 Python dependencies
├── pyproject.toml        # 🐍 Packaging & entry point config
├── .scan_history.json    # 📄 Logs: Stores past scan results (Auto-generated)
├── .github/              # 🚦 CI workflow + logo
└── core/                 # 🧠 Core Logic Folder
    ├── __init__.py       #    Package initializer
    ├── logo.py           #    🎨 Generates the ASCII Art Banner
    ├── help.py           #    ℹ️ Handles the Help Menu display
    ├── detector.py       #    🕵️ Main Logic: Scans IPs, Interfaces & DNS
    └── logger.py         #    💾 Handles saving data to JSON & exports

🛠️ Installation & Usage

Prerequisites

• Python 3.8 or higher
• Pip (Python Package Manager)

Step 1: Clone the Repository

git clone https://github.com/rkriad585/vpnActive.git
cd vpnActive

Step 2: Install Dependencies

pip install -r requirements.txt
# Or manually:
pip install psutil rich pyfiglet requests

Step 3: Run the Tool

python main.py

🎮 Command Usage Examples

1. Standard Network Scan

Performs a full check of interfaces, processes, and external IP.

python main.py

2. Kill Active VPNs ☠️

Requires Administrator/Root privileges. Attempts to terminate known VPN processes.

# Linux/Mac
sudo python main.py --kill

# Windows (Run cmd as Admin)
python main.py --kill

3. Help Menu ℹ️

Displays all available commands and flags.

python main.py --help

4. Scan History & Export 📊

Shows past scans, exports them, or clears them.

python main.py --history
python main.py --export csv        # json | csv | txt
python main.py --clear-history

5. Watch Mode 🔁

Continuously re-scans every N seconds (default 10). Press Ctrl+C to stop.

python main.py --watch 30

6. Exit Codes 🤖

Useful for scripting and automation.

Code	Meaning
0	No VPN detected (or clean exit)
1	VPN / Tor / Proxy detected
2	Offline, error, or invalid usage

⚙️ Configuration

You can customize the tool by editing config.py or by creating an optional JSON config file (.activevpn.json in the project root, or any path via the ACTIVEVPN_CONFIG environment variable). Keys in the file must match the uppercase constants in config.py.

{
  "VPN_INTERFACE_PATTERNS": ["tun", "tap", "wg"],
  "VPN_PROCESS_NAMES": ["openvpn", "mullvad"],
  "COLOR_SUCCESS": "bold cyan"
}

• Add new VPNs: Add process names to VPN_PROCESS_NAMES or interface prefixes to VPN_INTERFACE_PATTERNS.
• Change Colors: Modify the COLOR_* constants to theme the UI to your liking.
• Change APIs: Override IP_API_URLS, DNS_LEAK_API_URL, or the IP version endpoints.

🤝 Contributing & Issues

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Found a bug? Open an Issue to help us fix it!

🌐 Connect with Me

If you like this project, feel free to connect!

Platform	Username	Link
GitHub	@rkriad585	github.com/rkriad585
YouTube	@rkriad585	youtube.com/@rkriad585
X (Twitter)	@rk_riad585	x.com/rk_riad585
Facebook	@rkriad585	facebook.com/rkriad585
Instagram	@rkriad585	instagram.com/rkriad585
Threads	@rkriad585	threads.net/@rkriad585
Email	rkriad585	mailto:rkriad585@gmail.com

📜 License

Distributed under the MIT License. See LICENSE for more information.

---