Simple macOS CLI to connect/disconnect a Bluetooth device. Useful for AirPods or other Bluetooth headphones.

What's New


  • Attempt to fix disconnection issues by trying up to 10 times and waiting 500ms between attempts
  • Add rssi to the list of paired devices
  • Update swift-tools-version, set a deployment target, update ArgumentParser

screen shot 2019-02-16 at 11 30 23 am


Simple macOS CLI to connect/disconnect a Bluetooth device. I made it to easily connect my BeatsX earbuds (I thought the W1 chip would make the switch from my iPhone to my Mac seamless, but we're not there yet, apparently). There's probably a program that already does this but I didn't find it.

You can download a compiled version here:

If you have issues running the compiled binary (permission denied error), try running this command in Terminal: chmod +x /path/to/BluetoothConnector


brew install bluetoothconnector
mint install lapfelix/BluetoothConnector


swift package update
swift build -c release
mv .build/release/BluetoothConnector /usr/local/bin/BluetoothConnector



Replace 00-00-00-00-00-00 with your device's MAC address. You can get it by alt-clicking the Bluetooth menu icon or by running BluetoothConnector without any arguments

To toggle the connection (connect/disconnect) and be notified about it
BluetoothConnector 00-00-00-00-00-00 --notify
To connect and be notified about it
BluetoothConnector --connect 00-00-00-00-00-00 --notify
BluetoothConnector -c 00-00-00-00-00-00 --notify
To disconnect
BluetoothConnector --disconnect 00-00-00-00-00-00
BluetoothConnector -d 00-00-00-00-00-00
Notification Center

screen shot 2019-01-27 at 4 51 16 pm

You can have BluetoothConnector send a notification to say what it did (connect or disconnect), if the action succeeded or get an error description if something goes wrong

BluetoothConnector 00-00-00-00-00-00 --notify

To reduce Notification Center pollution, I'd recommend turning off "Show in Notification Center" for the Script Editor app in the Notifications system preferences:

screen shot 2019-01-27 at 4 51 16 pm

With Automator to bind a shortcut to it (this is how I'm using it)

I included an Automator workflow service that calls BluetoothConnector from /usr/local/bin to make it easier to run BluetoothConnector with a keyboard workflow (this is how I'm using it).

Then open the Automator workflow and you should get a prompt to install it (don't forget to change the MAC address). To bind a shortcut to the Automator service, launch System Preferences and Go to Keyboard > Shortcuts > Services, find your service and add a shortcut to it.


  • Swift Tools 5.9.0
View More Packages from this Author


Last updated: Mon May 27 2024 18:11:34 GMT-0900 (Hawaii-Aleutian Daylight Time)