Quick Start

Quick Start

A 60-second tour: scan → pick a module → run it.

---

1. Launch the console

sudo python3 bluesploit.py

You'll see the banner and a bsploit > prompt.

---

2. Discover nearby devices

bsploit > use recon/discovery
bsploit (recon/discovery) > set DURATION 10
bsploit (recon/discovery) > run

Output lists MAC, name, RSSI, and class-of-device for every responder.

---

3. Fingerprint a target

bsploit > use recon/version_fingerprint
bsploit (recon/version_fingerprint) > set TARGET AA:BB:CC:DD:EE:FF
bsploit (recon/version_fingerprint) > run

This identifies BT version, manufacturer, and likely chipset — useful for matching to known CVEs.

---

4. Scan for known vulns

bsploit > use scanners/vuln_scanner
bsploit (scanners/vuln_scanner) > set TARGET AA:BB:CC:DD:EE:FF
bsploit (scanners/vuln_scanner) > run

The scanner cross-references discovered properties against signatures in data/signatures/.

---

5. Run an exploit

bsploit > use exploits/knob
bsploit (exploits/knob) > show options
bsploit (exploits/knob) > set TARGET AA:BB:CC:DD:EE:FF
bsploit (exploits/knob) > check     # safe pre-flight
bsploit (exploits/knob) > run

Use back to leave the module, exit to quit the console.

---

CLI mode (no REPL)

python3 bluesploit.py --list                # list every module

---

Next: Console Commands for the full REPL reference, or Module Categories to browse what's available.