📡 WireTapper

WireTapper is a wireless OSINT tool designed to discover, map, and analyze radio-based devices using passive signal intelligence. It provides investigators, researchers, and security analysts with real-time visibility into the invisible wireless landscape around them.

WireTapper detects and correlates signals from common wireless technologies, helping users understand what devices exist, where they are likely located, and how they interact, without active intrusion.

WireTapper identifies leaked Wi-Fi network credentials based on privacy-protecting k-Anonymity query scheme.

🔗 Website: https://haybnz.web.app

🔗 Blog on WireTapper: Read on Medium

## 📶 Supported Signal Intelligence

WireTapper can identify and analyze signals from:

• Wi-Fi access points & clients, Wi-Fi credentials leak
• Bluetooth & BLE devices
• Wireless CCTV / IP cameras
• Vehicles broadcasting RF signals (infotainment, telemetry, keyless systems)
• Headphones, wearables, and smart devices
• Smart TVs & IoT appliances
• Cell towers & mobile network beacons

🔑 API Services

WireTapper integrates with several external services to provide intelligence. You will need to obtain API keys from the following:

• Wigle.net – Wireless network mapping and discovery.
• wpa-sec – Distributed WPA-PSK auditor database.
• OpenCellID – Open-source database of cell towers.
• Shodan – Search engine for Internet-connected devices.
  • Note: A Premium account is required to use Shodan's API with this tool.

📦 Installation & Quickstart

Option 1: Install via PIP (Recommended)

pip install wiretapper

Once installed, start WireTapper immediately:

wiretapper start

Or start on a custom port and automatically open the web browser:

wiretapper start --port 8080 --open-browser

Option 2: Install from Source

git clone https://github.com/h9zdev/WireTapper.git
cd WireTapper
pip install -e .

💻 CLI Usage

usage: wiretapper [-h] [-v] {start,run,server,info} ...

options:
  -h, --help       show this help message and exit
  -v, --version    show program's version number and exit

commands:
  start (run)      Start the WireTapper web dashboard
                   Options: --host, --port, --debug, --open-browser, --data-dir
  info             Show environment, storage, and version info

🔑 Configuration (API Keys)

You can configure API credentials (WiGLE, OpenCellID, Shodan, Censys) directly from the Settings modal in the Web UI, or via environment variables / .env file:

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

The application web UI is accessible at:

• http://localhost:8080 (WiFi & Telemetry Dashboard)
• http://localhost:8080/btscan (Bluetooth BLE Recon & RPA Resolver)

📷 Screenshots

📜 License

This project is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) License. See the LICENSE file for more details.

Unauthorized use is strictly prohibited.

📧 Contact: singularat@protn.me

☕ Support

Donate via Monero: 45PU6txuLxtFFcVP95qT2xXdg7eZzPsqFfbtZp5HTjLbPquDAugBKNSh1bJ76qmAWNGMBCKk4R1UCYqXxYwYfP2wTggZNhq

👥 Contributors and Developers

Star History