Skip to content
Projects

deweller/switchaudio-osx

View on GitHub

deweller/switchaudio-osx has 1,456 GitHub stars and 104 forks. GitHot measured 0 stars in 24 hours and +3 in 7 days. Last checked 2026-11-09 04:33 UTC. Last push 2024-07-07.

How these counts are measured

Change the audio source for Mac OS X from the command line.

Measured star growth

in 24h
0
in 7 days
+3
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

switchaudio-osx

A command-line utility to switch the audio source on Mac OS X.

Description

This utility switches the audio source for Mac OS X.

You specify the name of the audio source, such as Built-in Digital Output, and the utility switches the source immediately without any GUI interaction.

This is a command-line utility only and has no graphical user interface. Tested on OS 10.7 - 11.2.

Installing from homebrew

brew install switchaudio-osx

Usage

SwitchAudioSource [-a] [-c] [-f format] [-t type] [-n] -s device_name | -i device_id | -u device_uid

  • -a : shows all devices
  • -c : shows current device
  • -f format : output format (cli/human/json). Defaults to human.
  • -t type : device type (input/output/system). Defaults to output.
  • -m mute_mode : sets the mute status (mute/unmute/toggle).
  • -n : cycles the audio device to the next one
  • -i device_id : sets the audio device to the given device by id
  • -u device_uid : sets the audio device to the given device by uid or a substring of the uid
  • -s device_name : sets the audio device to the given device by name

Muting

The -m flag can be used to mute input or output devices.

Define the device via -t.

Example for toggling the mute state for the currently selected input, e.g. microphone:

SwitchAudioSource -m toggle -t input

This is useful on a hotkey, e.g. to mute your Teams or Zoom input.

Thanks

Thanks to Christian Zuckschwerdt for migrating this to github and adding the next option.

License

MIT License, see license.txt

Copyright (c) 2008-2021 Devon Weller [email protected]
Copyright (c) 2011 Christian Zuckschwerdt [email protected]

Explore related projects