🐧 Linux Installation Guide

🐧 WireTapper — Linux Installation Guide

Welcome! Here's how to get WireTapper up and running on Linux. 🚀

✅ Requirements

• 🐧 Any modern distro (Debian/Ubuntu, Arch, Fedora, Kali, etc.)
• 🐍 Python 3.10+ (for pip/source install)
• 🌐 Internet connection (for API lookups — Wigle, wpa-sec, OpenCellID, Shodan)
• 🛡️ sudo access (wireless interface scanning needs elevated permissions)

📦 Option 1: Standalone Binary (Easiest)

No Python required — just download and run.

1. ⬇️ Download the latest build:

   wget https://github.com/h9zdev/WireTapper/releases/download/WireTapper/WireTapper-Linux

2. 🔓 Make it executable:

   chmod +x WireTapper-Linux

3. ▶️ Run it:

   sudo ./WireTapper-Linux

(sudo is needed for raw wireless interface access)

🐍 Option 2: Install via PyPI (pip)

For the latest features and easier updates.

1. 🔎 Verify Python is installed:

   python3 --version

2. 📥 Install WireTapper:

   pip install wiretapper --break-system-packages

3. ▶️ Run it:

   wiretapper start

Or with custom parameters:

   # Start on custom port and auto-open browser
   wiretapper start --port 8080 --open-browser
 
   # Run with python module syntax
   python3 -m wiretapper start

4. 🔄 To update later:

   pip install --upgrade wiretapper --break-system-packages

🧰 Option 3: Run from Source (Developers)

1. 📂 Clone the repo:

   git clone https://github.com/h9zdev/WireTapper.git
   cd WireTapper

2. 🧪 (Recommended) Create a virtual environment:

   python3 -m venv venv
   source venv/bin/activate

3. 📦 Install dependencies:

   pip install -r requirements.txt

4. ▶️ Launch:

   sudo python3 main.py

Or build and install your own wheel:

   pip install -e . --break-system-packages
   # or
   pip install dist/wiretapper-1.0.0-py3-none-any.whl --break-system-packages

🌐 Access the Web UI

🖥️ Dashboard	🔗 URL
📶 WiFi & Telemetry Dashboard	http://localhost:8080
🔵 Bluetooth BLE Recon & RPA Resolver	http://localhost:8080/bts

🔑 API Key Setup

WireTapper uses a few external services. You can set your keys either before launch or live from the UI:

• Option A: Config File Add your keys to the config file:

    📁 config/
       └── 🔐 keys.env

    WIGLE_API_KEY=your_key_here
    SHODAN_API_KEY=your_key_here
    OPENCELLID_API_KEY=your_key_here

• Option B: In-App Settings UI Open the application dashboard in your browser and click the ⚙️ Settings gear icon in the navigation bar to enter or update your API credentials at runtime — no server restart needed.

🩹 Troubleshooting

⚠️ Issue	🛠️ Fix
wiretapper: command not found	Ensure ~/.local/bin is on your PATH, or reopen your terminal
Permission denied on wireless scan	Re-run with sudo
externally-managed-environment pip error	Add --break-system-packages, or use a virtualenv
No wireless interfaces detected	Check iw dev / ip link — driver may not support monitor mode
Port already in use	Run with wiretapper start --port <other_port>

🎯 You're all set!

Fire up WireTapper and start mapping. 📡🛰️🔍

⭐ If it's useful, consider starring the repo: github.com/h9zdev/WireTapper