Metadata-Version: 2.4
Name: wiretapper
Version: 1.0.0
Summary: Advanced Wireless Reconnaissance, BLE Surveillance Detection, and Flock ALPR Analytics Suite
Home-page: https://github.com/h9zdev/WireTapper
Author: h9zdev
License-Expression: CC-BY-NC-4.0
Project-URL: Homepage, https://github.com/h9zdev/WireTapper
Project-URL: Documentation, https://github.com/h9zdev/WireTapper#readme
Project-URL: Repository, https://github.com/h9zdev/WireTapper.git
Project-URL: Issues, https://github.com/h9zdev/WireTapper/issues
Keywords: wireless,wifi,wardriving,wigle,alpr,flock-safety,bluetooth,ble,surveillance-detection,reconnaissance,security
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Security
Classifier: Topic :: System :: Networking :: Monitoring
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Classifier: Framework :: Flask
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: LICENSE-NONCOMMERCIAL.md
Requires-Dist: Flask>=2.2.0
Requires-Dist: requests>=2.28.0
Requires-Dist: pandas>=1.5.0
Requires-Dist: cryptography>=39.0.0
Requires-Dist: bleak>=0.21.0
Requires-Dist: werkzeug>=2.2.0
Provides-Extra: dev
Requires-Dist: build>=1.0.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# 📡 WireTapper 

<p align="center">
  <img src="https://raw.githubusercontent.com/h9zdev/WireTapper/main/images/WireTapper.png" alt="WireTapper" />
</p>

> [!NOTE]
> **Wireless OSINT & Signal Intelligence Platform**

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.

<p align="center">
  🔗 <strong>Website:</strong>
  <a href="https://haybnz.web.app?utm_source=github.com">https://haybnz.web.app</a>
</p>

<p align="center">
  🔗 <strong>Blog on WireTapper:</strong>
  <a href="https://medium.com/@h9z/wire-tapper-wireless-osint-signal-intelligence-platform-e5104659a1cb?utm_source=github.com">
    Read on Medium
  </a>
</p>

<p align="center">
  <a href="https://github.com/sponsors/h9zdev">
    <img src="https://img.shields.io/badge/Make%20a%20Difference-Sponser%20My%20Work-6A1B9A?style=for-the-badge&logo=github&logoColor=white" alt="Support My Work" />
  </a>
</p>
<p align="center">
  <a href="https://github.com/h9zdev/WireTapper">
    <img src="https://img.shields.io/static/v1?label=Python&message=WireTapper&color=2A3E87&labelColor=6A7DA8&style=for-the-badge&logo=python&logoColor=white" />
  </a>
  <a href="https://github.com/h9zdev/WireTapper/issues">
    <img src="https://img.shields.io/github/issues/h9zdev/WireTapper?style=for-the-badge&color=8B0000&logo=github" />
  </a>
  <a href="https://github.com/h9zdev/WireTapper/network/members">
    <img src="https://img.shields.io/github/forks/h9zdev/WireTapper?style=for-the-badge&color=455A64&logo=github" />
  </a>
  <a href="https://github.com/h9zdev/WireTapper/stargazers">
    <img src="https://img.shields.io/github/stars/h9zdev/WireTapper?style=for-the-badge&color=FFD700&logo=github" />
  </a>
</p>

> [!Note]
> ## 🛰️ SocioSential — Social Media OSINT
> [![GitHub](https://img.shields.io/badge/GitHub-h9zdev%2FSocioSential-blue?logo=github&style=flat-square)](https://github.com/h9zdev/SocioSential)
> ## 📡 EthiFi — WiFi Deauther *(New Version)*
> [![GitHub](https://img.shields.io/badge/GitHub-h9zdev%2FEthiFi-green?logo=github&style=flat-square)](https://github.com/h9zdev/EthiFi)

<br>
## 📶 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](https://wigle.net/)** – Wireless network mapping and discovery.
*   **[wpa-sec](https://wpa-sec.stanev.org)** – Distributed WPA-PSK auditor database.
*   **[OpenCellID](https://opencellid.org/)** – Open-source database of cell towers.
*   **[Shodan](https://www.shodan.io/)** – 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)

```bash
pip install wiretapper
```

Once installed, start WireTapper immediately:
```bash
wiretapper start
```
Or start on a custom port and automatically open the web browser:
```bash
wiretapper start --port 8080 --open-browser
```

### Option 2: Install from Source

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

### 💻 CLI Usage

```text
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:
```bash
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

![WireTapper Image 1](https://raw.githubusercontent.com/h9zdev/WireTapper/main/images/Wiretapper11.png)  
![WireTapper Image 2](https://raw.githubusercontent.com/h9zdev/WireTapper/main/images/Wiretapper34.png)  
![WireTapper Image 3](https://raw.githubusercontent.com/h9zdev/WireTapper/main/images/Wiretapper354.png)  
![WireTapper Image 4](https://raw.githubusercontent.com/h9zdev/WireTapper/main/images/Wiretapper55.png)  
![WireTapper Image 5](https://raw.githubusercontent.com/h9zdev/WireTapper/main/images/Wiretapper568.png)


## 📜 License

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

**Unauthorized use is strictly prohibited.**

📧 Contact: singularat@protn.me

## ☕ Support

Donate via Monero: `45PU6txuLxtFFcVP95qT2xXdg7eZzPsqFfbtZp5HTjLbPquDAugBKNSh1bJ76qmAWNGMBCKk4R1UCYqXxYwYfP2wTggZNhq`

## 👥 Contributors and Developers

[<img src="https://avatars.githubusercontent.com/u/67865621?s=64&v=4" width="64" height="64" alt="haybnzz">](https://github.com/h9zdev)
 [<img src="https://avatars.githubusercontent.com/u/108749445?s=64&v=4"  width="64" height="64" alt="VaradScript">](https://github.com/varadScript)
## Star History

[![Star History Chart](https://api.star-history.com/svg?repos=h9zdev/WireTapper&type=timeline&legend=bottom-right)](https://www.star-history.com/#h9zdev/WireTapper&type=timeline&legend=bottom-right)
