SuperAPI AI 工具集

sonoscli

通用与其它

查看项目

更新于 10-15 20:27

技能介绍

用途:在本地网络中通过命令行控制 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 发现音箱,再用 --name 指定音箱名称执行对应子命令。若 SSDP 发现失败,可通过 --ip <speaker-ip> 直接指定音箱 IP。Spotify Web API 搜索为可选项,需要配置 SPOTIFY_CLIENT_ID 与 SPOTIFY_SECRET。

适用场景:需要在脚本或终端中快速控制局域网内 Sonos 音箱的播放、音量与分组。

限制:主要面向本地网络环境;网络发现依赖 SSDP,失败时需手动指定 IP;Spotify 相关搜索为可选功能并需要额外凭据;资料未提供更多平台兼容性、安装方式或收费信息。