What problem does it solve?
macOS users frequently struggle with manual, GUI-based management of Core Audio devices and routing, making tasks like switching default inputs/outputs, inspecting audio metadata, and batch conversions tedious and error-prone.
Core Features & Use Cases
- Wraps macOS Core Audio tools (afinfo, afplay, afconvert, say) for terminal use.
- Integrates SwitchAudioSource to change default input/output/system devices from scripts.
- Enumerates HAL plug-ins and prints BlackHole install guidance for podcasting and OBS workflows.
- Supports programmatic creation of Aggregate Devices via AppleScript (Audio MIDI Setup) or Swift APIs.
- Prints install instructions for popular virtual audio drivers (BlackHole) and guides rescan of coreaudio after changes.
Quick Start
List devices with macaudio.py list-devices and then set a default with macaudio.py set-default 'Device Name'.