macos-audio

通过 macos-audio 命令行工具控制 macOS 上的蓝牙设备、音频输出路由和音量。

安装

Brew 依赖

bash
brew install switchaudio-osx # 输出切换所需
brew install blueutil # 蓝牙控制所需

安装 CLI

bash
brew install vossenwout/tap/macos-audio-cli

命令

扫描与连接

bash
macos-audio scan # 清理分区：蓝牙、本地、AirPlay
macos-audio connect bt <名称|MAC地址>
macos-audio connect airplay
macos-audio connect local <名称>
macos-audio disconnect <目标> # 断开蓝牙并切换到本地输出

音量

bash
macos-audio volume set <0-100> # 设置系统输出音量
macos-audio volume get # 打印输出音量、输入音量、静音状态

播放

bash
macos-audio play <文件> # 播放本地音频文件
macos-audio play <文件> --background # 开始播放并立即返回

状态

bash
macos-audio status # 显示输出、音量、静音状态
macos-audio status --json # 同上，但输出机器可读的 JSON 格式
macos-audio status --device <名称|MAC地址> # 包含指定设备的蓝牙状态

退出码

工作流程指导

• - 在进行更改前，始终先运行 macos-audio status 了解当前状态。
• 如果命令以退出码 4 结束，说明缺少所需的 brew 依赖——请安装后重试。
• connect airplay 使用通用的 AirPlay 路由；扫描中的房间名称仅供参考。
• 蓝牙设备只有在 macOS 中手动配对后才会出现在扫描结果中。

限制

• - 不支持通过 ssh 使用
• connect airplay 已知存在缺陷，AirPlay 功能仍处于实验阶段