SuperAPI AI 工具集

sonoscli

通用与其它

查看项目

更新于 10-16 09:38

技能介绍

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 来复现)。