airfoil

🔊 命令行智控 AirPlay 多房间音响

依托 Rogue Amoeba Airfoil 的 CLI 工具,通过 AppleScript 让 macOS 用户在终端快速管理 AirPlay 扬声器,实现高效多房间音频控制。

收藏
7.8k
安装
2.3k
版本
v1.0.1
CLS 安全性认证2026-05-14
点击查看完整报告 >

使用说明

核心用法:Airfoil Skill 是 Rogue Amoeba Airfoil 应用的命令行封装层,通过 AppleScript 与本地 Airfoil 进程通信,提供 listconnectdisconnectvolumestatus 五大核心指令。用户可在终端直接列出可用 AirPlay 扬声器、建立连接、调节音量(0-100%)或批量断开,实现无需图形界面的纯文本音频控制。技能支持精确匹配扬声器名称(区分大小写),并与 Clawd 等 AI Agent 深度集成,支持语音指令转译为 CLI 操作。

显著优点:首先,它填补了 Airfoil 原生缺乏命令行接口的空白,让开发者能通过脚本批量控制多房间音频,适合搭建自动化场景(如"电影模式"一键切换电视音响并调节音量)。其次,与图形界面相比,CLI 操作响应更快,可嵌入 Homebrew 工作流或定时任务。再者,技能文档详尽,包含完整的故障排除指南和权限配置说明,降低了 AppleScript 交互的调试门槛。最后,作为纯本地执行工具,无需网络连接即可工作,隐私风险极低。

潜在缺点:平台锁定严重,仅限 macOS 系统且必须安装 $35 的 Airfoil 商业软件(虽有试用版)。用户体验上,扬声器名称需精确匹配(大小写敏感),误输会导致执行错误,缺乏模糊匹配或自动补全。权限配置较为繁琐,需手动在系统设置中授予 Terminal 和 Airfoil Accessibility 权限,对普通用户不够友好。此外,音量参数缺乏严格的边界校验(依赖 bc 计算),极端值可能导致意外行为。

适合人群:主要面向 macOS 重度用户、智能家居自动化爱好者、以及拥有多套 AirPlay 音响(如 Sonos、Apple TV、HomePod)的多房间音频用户。开发者和技术从业者能最大化利用其 CLI 特性,集成到现有脚本工作流;而普通用户若已使用 Airfoil 且熟悉终端操作,也能通过 Clawd 等 AI 助手获得便捷的语音控制体验。Windows 和 Linux 用户无法使用。

使用风险:技能本身虽无恶意代码,但依赖第三方 Airfoil 应用的稳定性和安全性,若 Airfoil 存在漏洞可能间接影响系统。AppleScript 交互需要 Accessibility 权限,误配置可能导致权限过度开放。性能方面,osascript 调用有一定延迟,不适合超低延迟实时控制场景。此外,bc 计算工具虽为 macOS 自带,但某些精简环境可能缺失,导致音量调节功能异常。建议用户仅从官方渠道安装 Airfoil,并定期检查脚本完整性。

安全解读

核心用法

Airfoil Skill 是一个 macOS 专属的命令行工具,通过 AppleScript 与 Rogue Amoeba 的 Airfoil 应用交互,实现对 AirPlay 音箱的完整控制。主要功能包括:

  • list: 列出网络中所有可用的 AirPlay 音箱
  • connect <speaker>: 连接指定音箱(名称需完全匹配,区分大小写)
  • disconnect <speaker>: 断开指定音箱连接
  • volume <speaker> <0-100>: 精确设置音箱音量
  • status: 查看当前已连接音箱及其音量状态

使用前需安装 Airfoil 应用($35,有免费试用),并在系统设置中授予 Terminal 和 Airfoil 辅助功能权限。

显著优点

1. 自动化友好: 纯 CLI 设计,完美融入 shell 脚本和自动化工作流
2. 多房间协同: 支持同时管理多个音箱,适合智能家居场景

3. 零网络依赖: 纯本地操作,无云端传输,隐私性极佳

4. 轻量无侵入: 仅依赖系统内置工具(osascript),无额外第三方依赖

5. Clawdbot 集成: 天然支持语音/聊天机器人控制,提升交互体验

潜在缺点与局限性

1. 平台锁定: 仅限 macOS,Windows/Linux 用户无法使用
2. 商业软件依赖: 必须购买 Airfoil($35),免费试用有限制

3. 权限门槛: 需要手动配置 Accessibility 权限,首次 setup 较繁琐

4. 名称敏感: 音箱名称必须完全匹配(含大小写),易因拼写错误失败

5. 无开源许可: 当前未明确开源许可证,存在使用条款模糊风险

适合人群

  • macOS 重度用户,习惯命令行操作
  • 智能家居爱好者,希望自动化音频场景
  • 多房间音响系统用户(Sonos、Apple TV、HomePod 等)
  • Clawdbot 用户,希望通过语音/聊天控制音箱

常规风险

1. AppleScript 注入: 用户输入的音箱名称未经严格过滤,理论上存在注入风险(实际影响有限)
2. 权限维持: 系统升级后可能需重新授予 Accessibility 权限

3. Airfoil 兼容性: 若 Airfoil 更新导致 AppleScript 接口变更,Skill 可能失效

4. 网络环境: 音箱需与 Mac 处于同一网络,跨 VLAN/复杂网络拓扑可能失败

airfoil 内容

手动下载zip · 3.7 kB
airfoil.shtext/x-shellscript
请选择文件