Using Shortcuts with SoundSource

On MacOS 12 (Monterey) and higher, SoundSource provides a slew of actions for use with the built-in Shortcuts app. These allow you to automate many different things, including changing device volumes, setting effect presets, toggling effects processing, and much more.

Shortcuts Actions

With the Shortcuts actions included in SoundSource, it’s possible to integrate SoundSource into larger external workflows. This section provides a brief explanation for each of the included actions.

Helpful Hints

Source: In this context, the word “Source” is used to mean an application, an input device, or an output device.

Chosen or supplied: Items listed as “chosen or supplied” can be either chosen from a popup menu or supplied via a “Magic Variable”.

  • Get Active Applications: Returns a list of all applications that are currently producing audio, or have done so in the past 15 seconds

  • Get Device List: Returns a list of all available devices for the system's audio output or audio input

  • Get Source Device: Returns the device used by the chosen or supplied Source

  • Get Source Effects: Returns a list of all effects loaded for the chosen or supplied Source

  • Open/Close Effect Window: Opens or closes the window for the selected effect within the specified Source

  • Set All Effects Bypass: Sets the entire processing chain for the chosen or supplied Source(s) to “Active” or “Bypassed”, or toggles the chain’s state

  • Set Device Mute: Sets the hardware mute for the chosen or supplied device(s) to “Muted” or “Unmuted” if supported by the device(s), or toggles the mute state

  • Set Device Sample Rate: Sets the sample rate for the chosen or supplied audio device(s)

  • Set Device Volume: Sets the hardware volume on the chosen or supplied audio device(s), if supported by the device(s)

  • Set Effect Bypass: Sets the specified (via Magic Variable) audio effect to “Active” or “Bypassed”, or toggles the effect’s state

  • Set Effect Preset: Selects the selected preset for the chosen audio effect

  • Set Magic Boost: Sets the “Magic Boost” feature for the chosen or supplied Source(s) to “Enabled” or “Disabled”, or toggles the feature’s state

  • Set Metering: Sets the level meters animation for the chosen or supplied Source(s) to “Active” or “Bypassed”, or toggles animation’s state

  • Set Source Device: Sets the device for the chosen or supplied Source

  • Set Source Effect Bypass: Sets the chosen or supplied audio effect to “Active” or “Bypassed”, or toggles the effect’s state, for the chosen or supplied Source

  • Set Source Mute: Sets the specified Source(s) to “Muted” or “Unmuted”

  • Set Source Volume: Sets the volume level of the selected Source(s) to the specified value

Example Shortcuts

Using Shortcuts, you can chain multiple actions together to create powerful changes that take effect automatically. Below, we've provided some examples.


Focus Mode: Mute audio from select apps, then start a specific music playlist.


Movie Mode: Set audio playback of the TV app, mute other sources, and turn on 'do not disturb'.


Call prep: set proper inputs and umute your mic.


Headphone EQ: Set an EQ preset based on the specific output device.

Keyboard ControlsPreferences