airfoil

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

🥥61总安装量 18评分人数 23
100% 的用户推荐

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

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范,无 eval/exec 等危险函数,无动态代码加载或网络下载执行
  • ✅ 数据隐私保护,无网络通信功能,所有操作限于本地 Airfoil 应用,不收集敏感信息
  • ✅ 权限由系统控制,需用户在系统设置中手动授予 Accessibility 权限,脚本无法绕过
  • ⚠️ 输入校验存在边界,音量参数未严格限制 0-100 范围,扬声器名称依赖 AppleScript 字符串处理
  • ⚠️ 依赖第三方商业软件 Airfoil,其安全性与稳定性由 Rogue Amoeba 负责

使用说明

核心用法: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 内容

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