Skip to content

🔎 Observe and control Bluetooth devices. Connecting to your devices has never been faster. A @raycast extension.

Notifications You must be signed in to change notification settings

VladCuciureanu/Toothpick

Repository files navigation

Toothpick

This extension lets you control your Bluetooth devices with a few keystrokes.
Connecting to your Bluetooth devices has never been faster :)

Header

Getting Started

Visit this extension's store page to get started.
After installing, follow the instructions on screen, and you should be good to go!

Setting up favorite devices

  1. Go to the extension's settings.
  2. Enable the desired number of favorite device commands.
  3. Ensure "Toothpick" (the extension) is highlighted (and not a command).
  4. Write your device's name in the corresponding preference field.

You should now be able to connect to your device of choice via the configured commands.

Enabling 'blueutil' backend

The default 'AppleScript' Bluetooth backend works and is available out-of-the-box on modern macOS installs.
That said, AppleScript itself is flaky at best. Various device-specific issues popped up with no way to reproduce them.
As a solution, Toothpick now has an opt-in Bluetooth backend based on 'blueutil'. It is more stable, faster and easy to set up.

  1. Install 'blueutil' via 'brew'.
  2. Go to the extension's settings.
  3. Click on the 'Bluetooth Backend' dropdown.
  4. Select 'blueutil (Experimental)'

As implied by the backend's name, this feature is experimental and hasn't been tested extensively.
If any issues pop up, please report them through the feedback links below.

Feedback

A lot of workarounds were used to implement many of the core functionalities.
Not to mention that this extension was also a whim project. So, I would be
happy to hear what you think of it and how it could be improved upon.

Contributing

There are many more devices I want to support and I need your help for that!
If you have any of the devices below or wish to have any unlisted device
supported, all you need to do is:

  1. Connect your device
  2. Open this extension in Raycast
  3. Highlight your device
  4. Press 'Command + K'
  5. Run 'Copy Device Data' command
  6. Paste your data in an issue using this template.
  7. ???
  8. Profit

Wanted devices

  • Beats X
  • Beats Solo 3
  • Beats Powerbeats
  • Beats Powerbeats 3
  • Beats Powerbeats Pro
  • Beats Studio 3

About

🔎 Observe and control Bluetooth devices. Connecting to your devices has never been faster. A @raycast extension.

Topics

Resources

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published