Files
scripts/system/audio-toggle

audio_toggle.sh

Switch PulseAudio/PipeWire audio output sinks.

Usage

./audio_toggle.sh [OPTION]

Options

Flag Description
(no args) Switch to the next available sink
--to <pattern> Switch to a sink whose name matches <pattern> (case-insensitive)
--prev, --previous Switch back to the previously active sink
--list List all available sinks with descriptions
--current Show the current default sink
--move-streams Also move existing audio streams to the new sink
--help, -h Show help message

Examples

audio_toggle.sh                    # next sink
audio_toggle.sh --to hdmi          # switch to HDMI sink
audio_toggle.sh --prev             # back to previous sink
audio_toggle.sh --list             # see what's available

Notes

  • Sinks named easyeffects are automatically filtered out.
  • The previous sink is stored in ~/.cache/audio-toggle-prev-sink.
  • Streams are not moved by default; use --move-streams to relocate them.