sonoscli

Sonos CLI

sonos を使用して、ローカルネットワーク上の 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"

注意事項

• SSDP が失敗した場合は、--ip <speaker-ip> を指定してください。
• Spotify Web API による検索は任意で、SPOTIFY_CLIENT_ID/SECRET が必要です。
• エラーが発生した場合は、トラブルシューティングのセクションを確認し、適切な対処方法が見つかれば案内してください。

トラブルシューティング

sonos discover - no route to host

• エラー Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1) が発生した場合
  • 0.0.0.0: の後に続くポート番号は一時的なもので、変わることに注意してください。また、ネットマスクも完全には一致しない場合があります。
  • sendto: no route to host は一貫して表示されるはずです。
• Mac OS の direct（Docker サンドボックスなし）モードでは、Gateway の最上位ホスト親プロセスに対して、設定 -> プライバシーとセキュリティ -> ローカルネットワークを有効にする必要があることをユーザーに案内してください。
  • launchd 経由で実行している場合は node
  • ターミナルで Gateway を直接実行している場合は Terminal
  • VS Code のターミナル経由で実行している場合は Visual Studio Code
• 別の方法として、ネットワークアクセスを許可した sandbox（Docker コンテナ）を使用できます。

sonos discover - bind: operation not permitted

• エラー Error: listen udp4 0.0.0.0:0: bind: operation not permitted が発生した場合
• ネットワークアクセスが許可されていない Codex またはその他のサンドボックス経由で実行している可能性があることをユーザーに案内してください（サンドボックスを有効にした Codex CLI セッション内で sonos discover を実行し、権限昇格のリクエストを承認しないことで再現できます）。