audio-coreaudio

Control macOS Core Audio devices and utilities from the terminal.

15|4|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/damionrashford/media-os --skill audio-coreaudio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audio-coreaudio
Source: https://github.com/damionrashford/media-os/tree/main/skills/audio-coreaudio
Command: npx skills add https://github.com/damionrashford/media-os --skill audio-coreaudio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

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'.

Frequently Asked Questions about audio-coreaudio

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch the default Core Audio input and output device from the terminal on macOS?

Switch the default Core Audio input and output device by running a script that wraps SwitchAudioSource, allowing you to programmatically set system audio devices without using the GUI.

Can I create macOS aggregate audio devices for screen recording and streaming via the command line?

Create macOS aggregate audio devices for screen recording and streaming by using integrated AppleScript commands or Swift APIs that programmatically configure Audio MIDI Setup.

What is the best way to batch convert and inspect audio file metadata on macOS without GUI tools?

Inspect and convert audio file metadata by wrapping native macOS utilities like afinfo, afplay, and afconvert for terminal-based batch processing and playback automation.

Does this Core Audio automation approach support virtual audio drivers like BlackHole for OBS workflows?

Yes, this approach supports virtual audio drivers like BlackHole by providing install guidance, enumerating HAL plug-ins, and triggering a coreaudio rescan for OBS workflows.

How do I automate Text-to-Speech tasks using macOS Core Audio utilities in scripts?

Automate Text-to-Speech tasks by wrapping the native macOS say command within terminal scripts, enabling programmatic TTS execution and audio playback routing.

Are there dry-run options when automating Core Audio device switching and file conversions?

Yes, dry-run options are available for automating Core Audio device switching and file conversions, alongside macOS environment guards to prevent unintended system changes.