blucli

BluOS CLI (blu) 是一款专为 Bluesound 和 NAD 多房间音频系统用户设计的专业自动化工具。它提供了一个直接且可脚本化的接口来与联网的音频播放器进行交互，弥补了硬件控制与终端工作流程之间的差距。无论您是要自动化家庭音频环境、管理多房间同步，还是将音频状态集成到您的个人 AI 助理仪表板中，此工具都能提供精细控制所需的接口。它主要针对高级用户、家庭自动化爱好者以及需要程序化访问音频播放状态（无需依赖专用移动应用程序）的开发人员。

• 完整控制播放状态，包括播放、暂停、停止和跳过功能。

• 高级多房间分组功能：动态添加或移除群组中的播放器，并检查当前的群组状态。

• 使用自定义标识符、别名或环境变量（如 BLU_DEVICE）进行实时设备发现与选择。

• 直接访问如 TuneIn 等流媒体服务，允许用户通过 CLI 搜索并触发广播电台或媒体内容的播放。

• 支持特定音量等级设置。

• 支持 JSON 输出，专为集成到 Shell 脚本、自动化流水线和 AI 代理工具集而设计。

• 请确保所有目标播放器与主机位于同一个局域网内，以确保设备发现顺利。

• 请使用 --json 参数以进行自动化解析和设备状态报告的程序化使用。

• 在执行播放变更之前，务必使用 devices 命令确认当前的活跃目标设备，以避免误触未预期的设备。

• 此工具在配置为个人 AI 助理的动作或技能时特别有效，可实现语音控制或情境感知的音频管理。

• 需要稳定的网络环境；请确保防火墙设置允许与 BluOS 发现端口进行通信。

• 非常适合在智能家居环境中建立自动化常规，例如“早晨音乐”触发器或“全部停止”关机指令。