Metadata-Version: 2.4
Name: blue-tap
Version: 2.6.0
Summary: Bluetooth/BLE Penetration Testing Toolkit for Automotive IVI Systems
Author: Santhosh Ballikonda
License: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/Indspl0it/blue-tap
Project-URL: Repository, https://github.com/Indspl0it/blue-tap
Project-URL: Issues, https://github.com/Indspl0it/blue-tap/issues
Project-URL: Changelog, https://github.com/Indspl0it/blue-tap/blob/main/docs/changelog.md
Project-URL: Documentation, https://Indspl0it.github.io/blue-tap/
Keywords: bluetooth,ble,pentest,security,automotive,ivi,fuzzing
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
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: Topic :: Security
Classifier: Topic :: System :: Networking
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.1
Requires-Dist: rich>=13.0
Requires-Dist: rich-click>=1.8
Requires-Dist: bleak>=0.21
Requires-Dist: dbus-fast>=2.0
Requires-Dist: scapy>=2.5
Requires-Dist: pulsectl>=23.5
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Dynamic: license-file

  Blue-Tap Banner

  Bluetooth/BLE Penetration Testing Toolkit for Automotive IVI Systems

  Python 3.10+
  License GPL-3.0
  Version 2.6.0

---

Blue-Tap is a Bluetooth Classic and BLE penetration testing toolkit built for automotive IVI security assessments. It operates at both the HCI layer and below-HCI via DarkFirmware on RTL8761B.

96 registered modules across 6 families: discovery, reconnaissance, assessment, exploitation, post-exploitation, and fuzzing.

- **Discovers, fingerprints, and assesses** Bluetooth devices with 25 CVE detections, 11 posture checks, and 30 denial-of-service probes
- **Exploits** protocol vulnerabilities: BIAS, KNOB, BLUFFS, SSP downgrade, encryption downgrade, connection hijacking
- **Extracts data and intercepts audio** via PBAP, MAP, HFP, A2DP, AVRCP, AT commands, OBEX
- **Fuzzes 16 Bluetooth protocols** with a response-guided engine, crash database, and minimization

## Installation

```bash
git clone https://github.com/Indspl0it/blue-tap.git
cd blue-tap
pip install -e .
```

Verify:

```bash
sudo blue-tap --version
sudo blue-tap adapter list
```

## Documentation

Full documentation: **[docs/](docs/index.md)**

- [CLI Reference](docs/guide/cli-reference.md)
- [Getting Started](docs/getting-started/installation.md)
- [CVE Detection Matrix](docs/cve/detection-matrix.md)
- [Hardware Compatibility](docs/reference/hardware-compatibility.md)
- [Troubleshooting](docs/reference/troubleshooting.md)
- [Changelog](docs/changelog.md)

## Legal Disclaimer

Blue-Tap is provided for authorized security testing and research purposes only. You must have explicit written permission from the owner of any device you test. Unauthorized access to Bluetooth devices is illegal under the Computer Fraud and Abuse Act (CFAA), the UK Computer Misuse Act, and similar laws worldwide. The authors accept no liability for misuse. Report vulnerabilities responsibly to the affected manufacturer.

## License

[GNU General Public License v3.0](LICENSE) — Copyright (C) 2026 Santhosh Ballikonda

---

**Santhosh Ballikonda** — [@Indspl0it](https://github.com/Indspl0it)
