BluePhantom v2.0 is a macOS Bash script that allows you to automatically connect to Bluetooth devices and record audio.
- Scans and lists available Bluetooth devices.
- Connects to the selected device.
- 5-second countdown before recording starts.
- Saves recordings in
.wavformat on the desktop. - Shows real-time connection status and progress during recording.
-
macOS ✅ Fully supported
- Requires
blueutilandsox. The script can automatically install them via Homebrew.
- Requires
-
Linux
⚠️ Limited support -
Can be tried using
bluetoothctl,hcitool, or PythonPyBluez. -
The script may not work directly on Linux; minor modifications may be required.
-
Windows ❌ Not suported
- Running on Windows requires WSL or other adaptations.
- [Homebrew]
- [blueutil]
- [sox]
The script automatically checks and installs missing dependencies.
- Clone the repository:
git clone https://github.com/username/BluePhantom.git
cd BluePhantom
chmod +x bluephantom.sh
bash bluephantom.sh