blucli

• 您希望通过脚本、Shell 别名或 AI 代理自动控制 Bluesound 或 NAD 播放器，而无需打开 BluOS 应用。
• 您管理多房间音频系统，需要通过脚本对多台设备进行分组、播放变更或音量调节。
• 您希望将 TuneIn 电台搜索与播放功能集成到更广泛的自动化工作流中。
• 您偏好使用快速、可脚本化的 CLI，并通过结构化的 --json 输出供程序化使用。

• 您没有 Bluesound 或 NAD 设备 — blu 专为 BluOS 生态系统设计。
• 您需要图形界面或移动端友好的控制方式；官方 BluOS 应用更适合满足这一需求。

运行 blu devices 列出网络上所有 BluOS 播放器。通过 --device <id|name|alias> 参数、BLU_DEVICE 环境变量或已保存的配置默认值来指定目标设备——选择最适合您工作流程的方式即可。

发出 blu play、blu pause 和 blu stop 命令，控制任意目标播放器的播放状态。随时使用 blu --device <id> status 查看当前状态。

使用 blu volume set <level> 精确设置音量，轻松编写定时音量变更脚本，或将音量控制集成到自动化流程中。

使用 blu group status、blu group add 和 blu group remove 管理 BluOS 播放器分组，通过命令行构建或解散同步的多房间音频区域。

使用 blu tunein search "查询内容" 搜索 TuneIn 电台，并通过 blu tunein play "查询内容" 立即开始播放，无需手动操作应用即可实现电台自动化控制。

向任意命令传入 --json 参数，即可获得结构化的 JSON 输出，使 blucli 轻松集成到 Shell 脚本、AI 智能体流水线以及其他自动化工具中。

使用定时脚本，每天早晨自动将音量调节至舒适水平，并在所有分组房间中启动 TuneIn 广播电台，无需手动操作 BluOS 应用。

只需一条 shell 命令或 AI 代理指令，即可在聚会中快速将多个 Bluesound 播放器分组并启动同步播放。

将 blu 集成到 AI 代理工作流中，使"暂停客厅音箱"之类的自然语言请求直接转换为针对正确设备的 blu pause 命令。

在监控脚本中轮询 blu --device <id> status --json，以跟踪各设备的播放状态，并根据当前播放内容触发条件操作。