SuperAPI AI 工具集

sonoscli

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:sonoscli 用于在本地网络中通过命令行控制 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。
  • 搜索:sonos smapi search --service "Spotify" --category tracks "query",通过 SMAPI 搜索 Spotify 内容。

使用方式:按上述命令组合使用;若 SSDP 发现失败,可加 --ip <speaker-ip> 指定音箱 IP。Spotify Web API 搜索为可选功能,需配置 SPOTIFY_CLIENT_ID/SECRET。

限制与排错:

  • discover 报 no route to host 时,Mac OS 直连(非 Docker 沙箱)模式下需在 设置 -> 隐私与安全性 -> 本地网络 中为网关的顶层父进程启用权限,例如通过 launchd 运行时的 node、直接在终端运行网关时的 Terminal,或在 VS Code 终端中运行时的 Visual Studio Code;也可改用允许网络访问的 Docker 沙箱。
  • 报 bind: operation not permitted 时,通常是因为运行在 Codex 等不允许网络访问的沙箱中,可调整沙箱网络权限或批准升级请求。
  • 遇到错误时应查阅故障排查章节,并在有合适匹配时给出建议。

其他信息(如收费、价格、平台支持范围、具体安装步骤)暂未提供。