SoundSource provides a slew of actions for use with MacOS’s Shortcuts automation app. These allow you to automate many different things, including changing device volumes, setting effect presets, toggling effects processing, and much more.
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.
Create an Output Group: Creates a new output group
Delete Output Group: Deletes the specified output group
Get Active Applications: Returns a list of all applications that are currently producing audio, or have done so in the past 60 seconds
Get Device: Returns the chosen or supplied device
Get Device List: Returns a list of all available devices for the system’s audio output or audio input
Get Effect: Returns any effect available for the chosen or supplied source
Get Output Group: Gets an output group from a selection
Get Source: Returns the chosen or supplied Source object
Get Source Device: Returns the device used by the chosen or supplied Source
Get Source Effects: Returns all effects assigned to the targeted 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), including an increase or decrease by a specific percentage.
Set Effect Bypass: Sets the specified (via Magic Variable) audio effect to “Active” or “Bypassed”, or toggles the effect’s state
Set Effect Parameter: Sets a specific parameter on a chosen audio effect
Set Group Device Volume: Sets the volume for devices in the specified or chosen output group
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 Output Group Devices: Sets the devices for the specified or chosen output group
Set Quick Config: Applies the Quick Config to be used by SoundSource
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 Effect Preset: Selects the selected preset for the chosen audio effect
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, including an increase or decrease by a specific percentage.
Using Shortcuts, you can chain multiple actions together to create powerful changes that take effect automatically. Below, we’ve provided some examples.
Airfoil
Audio Hijack
Farrago
Fission
Loopback
Piezo
SoundSource