📋

Sonoscli

通过命令行控制 Sonos 音响——发现设备、管理播放、调节音量、组织分组。

Peter Steinbergerv1.0.0
Productivity & TasksProductivityOpen SourceAutomationCLIDeveloper Tool
正在连接 VM...
正在连接 VM...
npx clawhub@latest install sonoscli
5当前安装数
1.3k累计安装数
v1.0.0版本

系统要求

Spotify API Credentials(optional)
查看源码(ClawHub)
  • 发现扬声器 — 通过 SSDP 自动发现局域网上的所有 Sonos 设备。
  • 播放控制 — 按名称播放、暂停或停止任意扬声器。
  • 音量管理 — 精确设置各个扬声器的音量级别。
  • 分组控制 — 使用简单命令加入、退出、派对模式或独奏扬声器。
  • 收藏和队列 — 浏览和播放 Sonos 收藏，管理播放队列。
  • Spotify 搜索 — 通过 SMAPI 搜索 Spotify 曲目（需要可选的 Spotify 凭据）。

工作原理

1

Step 1

安装 CLI
sonos 二进制文件通过 Go 安装，直接通过局域网与 Sonos 扬声器通信。
2

Step 2

发现设备
运行 sonos discover，使用 SSDP 多播查找所有扬声器。如果 SSDP 失败，可用 --ip 直接指定扬声器 IP。
3

Step 3

执行命令
使用 --name 按名称定向扬声器，并执行播放、音量或分组命令。
4

Step 4

可选 Spotify 集成
提供 SPOTIFY_CLIENT_ID 和 SPOTIFY_CLIENT_SECRET 环境变量，通过 SMAPI 协议启用 Spotify 搜索。

核心功能

零云依赖
直接通过局域网与 Sonos 扬声器通信；基本使用无需 Sonos 账户。
按名称定向扬声器
使用 --name "房间名称" 通过 Sonos 房间标签定向任意扬声器。
分组管理
完整的分组生命周期：检查状态、加入、退出、派对模式和独奏。
队列控制
列出、播放和清除播放队列。
收藏播放
从 CLI 列出并打开 Sonos 收藏。
Spotify SMAPI 搜索
无需离开终端即可搜索 Spotify 内容（需要可选凭据）。

系统要求

Sonos 扬声器
与运行 CLI 的机器在同一局域网上的一个或多个 Sonos 设备。
Go 工具链
通过 go install 安装 sonos 二进制文件所需。
网络访问
SSDP 多播必须可达；如果不可达，使用 --ip <speaker-ip> 作为备用。
Spotify 凭据（可选）
仅 Spotify SMAPI 搜索需要 SPOTIFY_CLIENT_ID 和 SPOTIFY_CLIENT_SECRET。

使用场景

家庭自动化脚本
作为 shell 脚本或 cron 任务的一部分，触发音乐播放、调节音量或静音扬声器。
AI 助手集成
让 Clawdbot 通过自然语言命令控制您的 Sonos 扬声器。
早晨/晚间例行程序
在设定时间自动化扬声器分组和音量级别。
开发环境
在专注工作时，无需离开终端即可快速静音或控制扬声器。

安装方式

1
Run in your terminal
npx clawhub@latest install sonoscli
or
2
Click the Install button at the top of this page for one-click setup

常见问题

评价

0 条评价

登录后撰写评价

暂无评价。来分享你的使用体验吧！