📋

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 則評價

登入後撰寫評價

尚無評價。來分享你的使用體驗吧！