📋

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)
  • スピーカーの検出 — 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 統合
SMAPI プロトコル経由で Spotify 検索を有効にするには、SPOTIFY_CLIENT_IDSPOTIFY_CLIENT_SECRET 環境変数を提供する。

主な機能

クラウド依存なし
ローカルネットワーク経由で Sonos スピーカーと直接通信;基本的な使用には Sonos アカウント不要。
名前によるスピーカーのターゲット指定
--name "部屋名" を使用して Sonos の部屋ラベルで任意のスピーカーをターゲットにする。
グループ管理
完全なグループライフサイクル:ステータス確認、参加、退出、パーティーモード、ソロ。
キューコントロール
再生キューの一覧表示、再生、クリア。
お気に入り再生
CLI から Sonos のお気に入りを一覧表示して開く。
Spotify SMAPI 検索
ターミナルを離れることなく Spotify コンテンツを検索(オプションの認証情報が必要)。

動作要件

Sonos スピーカー
CLI を実行するマシンと同じローカルネットワーク上の 1 台以上の Sonos デバイス。
Go ツールチェーン
go install 経由で sonos バイナリをインストールするために必要。
ネットワークアクセス
SSDP マルチキャストが到達可能である必要があります;そうでない場合は --ip <speaker-ip> をフォールバックとして使用する。
Spotify 認証情報(オプション)
Spotify SMAPI 検索にのみ SPOTIFY_CLIENT_IDSPOTIFY_CLIENT_SECRET が必要。

ユースケース

ホームオートメーションスクリプト
シェルスクリプトや 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件のレビュー

レビューを書くにはログイン

まだレビューはありません。最初の体験をシェアしましょう!