用途:在本地网络中控制 Sonos 音箱,提供命令行方式完成发现、状态查询、播放控制、音量设置与分组等操作。
主要能力:
- 发现设备:sonos discover
- 查看状态:sonos status --name "Kitchen"
- 播放控制:sonos play|pause|stop --name "Kitchen"
- 音量设置:sonos volume set 15 --name "Kitchen"
- 分组:sonos group status|join|unjoin|party|solo
- 收藏:sonos favorites list|open
- 队列:sonos queue list|play|clear
- Spotify 搜索(经 SMAPI):sonos smapi search --service "Spotify" --category tracks "query"
使用方式:在本地网络的终端中执行上述命令;若 SSDP 失败,可指定 --ip <speaker-ip>。Spotify Web API 搜索为可选项,需要 SPOTIFY_CLIENT_ID/SECRET。出错时可查看故障排查部分并给出匹配建议。
限制与排查:
- sonos discover 出现 no route to host 时,在 Mac OS 直连(非 Docker 沙箱)模式下,需为 Gateway 的顶层宿主父进程开启“设置 -> 隐私与安全性 -> 本地网络”,如通过 launchd 运行则为 node,终端直接运行则为 Terminal,VS Code 终端内运行则为 Visual Studio Code;替代方案是使用允许网络访问的沙箱(Docker 容器)。
- 出现 bind: operation not permitted 时,可能运行在 Codex 等不允许网络访问的沙箱中(例如在启用沙箱且未批准提权请求的 Codex CLI 会话中运行 sonos discover 可复现)。
资料未提供安装方式、收费信息与价格。