🚀 Installation & Configuration

🚀 Installation & Configuration

Follow these steps to set up and start WireTapper:

1️⃣ Clone the repository

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

2️⃣ Install dependencies

It is recommended to use a Python virtual environment.

🐧 Linux

python3 -m venv venv
source venv/bin/activate
pip install -r WireTapper.txt

🍎 macOS

python3 -m venv venv
source venv/bin/activate
pip install -r WireTapper.txt

🪟 Windows

python -m venv venv
venv\Scripts\activate
pip install -r WireTapper.txt

3️⃣ Configure API Keys

API credentials are saved directly into a local SQLite database (credentials.db). You can configure them in one of two ways:

• 🔧 Option A: .env File (Automatic Seeding) Create or edit the .env file in the root directory:

    WIGLE_API_NAME=your_wigle_api_name
    WIGLE_API_TOKEN=your_wigle_api_token
    OPENCELLID_API_KEY=your_opencellid_api_key
    SHODAN_API_KEY=your_shodan_api_key
    CENSYS_API_ID=your_censys_api_id
    CENSYS_API_SECRET=your_censys_api_secret

✨ On application startup, `app.py` automatically initializes `credentials.db` and populates any missing keys from your `.env` file.

• ⚙️ 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 — without restarting the server.

4️⃣ Launch Application

🐧 Linux / 🍎 macOS

sudo python3 app.py

🪟 Windows

python app.py

🤖 Installation on Android (Termux)

pip install wiretapper --break-system-packages

• 🤖 Installation via (Android)

🖥️ Interface	🔗 URL
📡 Main Signal Intelligence Dashboard	http://localhost:8080/map-w (or http://localhost:8080/)
🔵 Bluetooth LE & RPA Radar Interface	http://localhost:8080/btscan

📦 Standalone Binaries (No Python Required)

🖥️ Platform	⬇️ Download
🐧 Linux	WireTapper-Linux
🍎 macOS	WireTapper-macOS
🪟 Windows	WireTapper-Windows.exe

🐧 Linux

chmod +x WireTapper-Linux
sudo ./WireTapper-Linux

🍎 macOS

chmod +x WireTapper-macOS
xattr -d com.apple.quarantine WireTapper-macOS
sudo ./WireTapper-macOS

🪟 Windows

Right-click WireTapper-Windows.exe → Run as administrator.

🐍 Or via PyPI

pip install wiretapper --break-system-packages
wiretapper start