How do I install the Macos Audio skill?

Run npx skillmds@latest add dvcrn/macos-audio in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Macos Audio safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Macos Audio?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Macos Audio free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Macos Audio?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Macos Audio by dvcrn — Agent Skill

Name: Macos Audio
Rating: 4.2 (5 reviews)
Author: dvcrn

Macos Audio

Manage macOS audio output and Bluetooth devices via the macos-audio CLI. Use when scanning paired devices, connecting or disconnecting Bluetooth, switching audio output (including AirPlay), getting or setting volume, playing audio files, or checking audio status.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

macos-audio

Control Bluetooth devices, audio output routing, and volume on macOS through the macos-audio CLI.

Installation

Brew dependencies

brew install switchaudio-osx   # required for output switching
brew install blueutil           # required for Bluetooth control

Install the CLI

brew install vossenwout/tap/macos-audio-cli

Commands

Scan & connect

macos-audio scan                # clean sections: Bluetooth, Local, AirPlay
macos-audio connect bt <name|mac>
macos-audio connect airplay
macos-audio connect local <name>
macos-audio disconnect <target> # disconnect bluetooth and switch to local output

Volume

macos-audio volume set <0-100>  # set system output volume
macos-audio volume get          # print output volume, input volume, mute state

Playback

macos-audio play <file>                    # play a local audio file
macos-audio play <file> --background       # start playback and return immediately

Status

macos-audio status                         # show output, volume, mute state
macos-audio status --json                  # same but machine-readable JSON
macos-audio status --device <name|mac>     # include bluetooth status for a specific device

Exit codes

Code	Meaning
0	Success
1	Runtime error
2	Bad arguments
3	Target resolution error
4	Missing tool dependency (blueutil or SwitchAudioSource not installed)

Workflow guidance

Always run macos-audio status first to understand the current state before making changes.
If a command exits with code 4, the required brew dependency is missing — install it and retry.
connect airplay uses the generic AirPlay route; room names in scan are informational.
Bluetooth devices only appear in scan after manual pairing in macOS.

Limitations

Doesn't work over ssh
connect airplay is known to be buggy and airplay functionality is still experimental

---name: macos-audiodescription: Manage macOS audio output and Bluetooth devices via the macos-audio CLI. Use when scanning paired devices, connecting or disconnecting Bluetooth, switching audio output (including AirPlay), getting or setting volume, playing audio files, or checking audio status.---# macos-audioControl Bluetooth devices, audio output routing, and volume on macOS throughthe `macos-audio` CLI.## Installation### Brew dependencies```bashbrew install switchaudio-osx # required for output switchingbrew install blueutil # required for Bluetooth control```### Install the CLI```bashbrew install vossenwout/tap/macos-audio-cli```## Commands### Scan & connect```bashmacos-audio scan # clean sections: Bluetooth, Local, AirPlaymacos-audio connect bt <name|mac>macos-audio connect airplaymacos-audio connect local <name>macos-audio disconnect <target> # disconnect bluetooth and switch to local output```### Volume```bashmacos-audio volume set <0-100> # set system output volumemacos-audio volume get # print output volume, input volume, mute state```### Playback```bashmacos-audio play <file> # play a local audio filemacos-audio play <file> --background # start playback and return immediately```### Status```bashmacos-audio status # show output, volume, mute statemacos-audio status --json # same but machine-readable JSONmacos-audio status --device <name|mac> # include bluetooth status for a specific device```## Exit codes| Code | Meaning ||------|---------|| 0 | Success || 1 | Runtime error || 2 | Bad arguments || 3 | Target resolution error || 4 | Missing tool dependency (blueutil or SwitchAudioSource not installed) |## Workflow guidance- Always run `macos-audio status` first to understand the current state before making changes.- If a command exits with code 4, the required brew dependency is missing — install it and retry.- `connect airplay` uses the generic `AirPlay` route; room names in scan are informational.- Bluetooth devices only appear in scan after manual pairing in macOS.## Limitations- Doesn't work over ssh- `connect airplay` is known to be buggy and airplay functionality is still experimental

Frequently asked questions