How tarlogicsecurity/bluespy works
BlueSpy is a Bluetooth-audio recording and playback proof of concept. Its main workflow accepts a target address, attempts pairing, connects, records audio to a file, and optionally plays it back. The README also documents separate pairing, connection, and recording entry points. The sampled source shows the orchestration and command execution; the README identifies the external tools and runtime requirements.
Main entry points: BlueSpy.py CLI workflow · core.py Record audio · system.py Command runner · interface.py Text interface
Components 13
Workflow
- CLI workflow
BlueSpy.py
Bluetooth
- Pair target
core.py - Connect target
core.py - Address helpers
core.py - BlueZ tools
Audio
- Record audio
core.py - Play recording
core.py - PulseAudio tools
- Audio file
Support
- Text interface
interface.py - Command runner
system.py
Other components
- Operator
- Bluetooth device
Connections 19
- Operator → CLI workflow: runs
README.md - CLI workflow → Pair target: pairs
BlueSpy.py - CLI workflow → Connect target: connects
BlueSpy.py - CLI workflow → Record audio: records
BlueSpy.py - CLI workflow → Play recording: optionally plays
BlueSpy.py - CLI workflow → Text interface: prompts and logs
BlueSpy.py - Pair target → Command runner: executes commands
core.py - Connect target → Command runner: executes commands
core.py - Record audio → Command runner: executes commands
core.py - Play recording → Command runner: executes command
core.py - Pair target → BlueZ tools: uses btmgmt
core.py - Connect target → BlueZ tools: uses bluetoothctl
core.py - Record audio → Address helpers: derives device names
core.py - Record audio → PulseAudio tools: selects profile and captures
core.py - Play recording → PulseAudio tools: uses paplay
core.py - Record audio → Audio file: writes
README.md - Play recording → Audio file: reads
README.md - Pair target → Bluetooth device: pairs with
- Connect target → Bluetooth device: connects to