AirBuddy Help CenterSend Feedback

How to use the Shortcuts actions provided by AirBuddy

AirBuddy comes bundled with a bunch of actions for the Shortcuts app on macOS Monterey. You can use the actions provided by AirBuddy in combination with actions from the system and other apps to create powerful automations based on data from the devices you use with AirBuddy, or to automate actions such as connection and disconnection of AirPods and changes in settings.

For boring technical reasons, the actions provided by AirBuddy in the Shortcuts app show up under "AirBuddyHelper".

Ensure that "Enable AirBuddy" is turned on in AirBuddy's settings under "General", otherwise the app's Shortcuts actions won't work.

Example Shortcuts

Here are a few example Shortcuts to get you inspired:

  • Check AirPods Battery: checks the battery level on a given AirPods device and displays a macOS notification if the level is below 20%
  • Check AirPods Firmware: for all AirPods or Beats devices you have in AirBuddy, checks if there are any firmware updates available and displays a macOS notification if so
  • Video Conference with Airpods: finds any calendar event in the next 30 minutes that has a video conference call URL, connects the selected AirPods in a mode appropriate for use with video conferencing software (enabling the microphone and optionally changing listening mode to Transparency), then opens the video conference URL in Safari or Google Chrome (configurable when importing the shortcut)
  • Toggle Head Tracking: toggles Spatial Audio head tracking on/off (requires AirBuddy 2.6 or later)

Available Actions

Get Device List

Gets a list of your devices from AirBuddy. The list can be filtered by device type, nearby state, and connection state. One of the items from this action's output can be used as an input for some of AirBuddy's other actions such as "connect headset" or "disconnect headset".

Get Device State

Gets and returns the current state for one of your nearby devices. The result is a "Device Status" that contains lots of information about your device, such as the current battery level for every device part (if the device has multiple parts), whether or not there's audio being played on the device, which buds are in your ear or not, whether or not the device is connected to the Mac, and much more.

Get Device Battery Information

From a given device, get the battery level and charging state of its battery or batteries.

Connect Headset

Connects one of your headsets to the Mac. You can also configure a listening mode to be applied after connection and whether the Mac's audio input should be switched to the headset.

Disconnect Headset

Disconnects the currently connected headset from your Mac. You can also configure it to disconnect only a specific headset, if it's connected.

Get Device Headset State Details

Gets the current state of a headset, such as which buds are in-ear or in the charging case, if the charging case has the lid open, and more.

Get Device Firmware Version

Gets the firmware version currently installed on your AirPods or Beats headset

Get Latest Firmware Version

Gets the latest firmware version available for a given model of AirPods or Beats headset.

Get Spatial Audio State

Outputs details about Spatial Audio, such as whether it is available, which codec is currently playing, and whether head tracking is enabled.

Set Spatial Audio Mode

Configure Spatial Audio modes for the currently connected headset.

Spatial Audio actions require AirBuddy 2.6 or later and a Mac with Apple Silicon. Changing Spatial Audio or Spatialize Stereo settings is only available when supported content is playing in a media app such as Music.