Sonos CLI 是一个用于在本地网络中控制 Sonos 音箱的命令行工具。
用途
通过 sonos 命令控制本地网络中的 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"
使用方式
快速开始示例:
sonos discover
sonos status --name "Kitchen"
sonos play|pause|stop --name "Kitchen"
sonos volume set 15 --name "Kitchen"
注意事项
- 如果 SSDP 失败,可指定 --ip <speaker-ip>。
- Spotify Web API 搜索为可选功能,需要 SPOTIFY_CLIENT_ID/SECRET。
- 如果出现错误,请检查故障排除部分,并在有合适匹配时提供建议。
故障排除
sonos discover - no route to host
错误示例:Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1)
注意 0.0.0.0: 后面的端口号是临时的,会变化,子网掩码也可能不完全匹配。sendto: no route to host 应保持一致。
建议用户:在 Mac OS 上以直接模式(无 Docker 沙箱)运行时,需要为 Gateway 的顶层宿主父进程启用“设置 -> 隐私与安全性 -> 本地网络”:
- 如果通过 launchd 运行,则为 node
- 如果直接在终端运行网关,则为 Terminal
- 如果在 VS Code 的终端中运行,则为 Visual Studio Code
另一种选择是使用允许网络访问的沙箱(Docker 容器)。
sonos discover - bind: operation not permitted
错误示例:Error: listen udp4 0.0.0.0:0: bind: operation not permitted
建议用户:可能正在通过 Codex 或其他不允许网络访问的沙箱运行(可在启用沙箱且未批准升级请求的 Codex CLI 会话中运行 sonos discover 来复现)。