name: blucli
description: BluOS 命令行工具 (blu)，用于设备发现、播放控制、分组管理和音量调节。
homepage: https://blucli.sh
metadata: {"clawdbot":{"emoji":"🫐","requires":{"bins":["blu"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/blucli/cmd/blu@latest","bins":["blu"],"label":"安装 blucli (go)"}]}}

blucli (blu)

使用 blu 命令控制 Bluesound/NAD 播放器。

快速开始

• blu devices (选择目标设备)
• blu --device <id> status (查看指定设备状态)
• blu play|pause|stop (播放/暂停/停止)
• blu volume set 15 (设置音量为15)

目标设备选择 (按优先级排序)

1. --device <id|name|alias> (命令行指定)
2. BLU_DEVICE (环境变量)
3. config default (配置文件默认值，如已设置)

常用操作

• 设备分组：blu group status|add|remove
• TuneIn 搜索/播放：blu tunein search "关键词", blu tunein play "关键词"

使用建议

• 脚本调用时建议使用 --json 参数以获取结构化输出。
• 在执行播放控制等操作前，请务必确认目标设备是否正确。