Sonos CLI
Verwende sonos, um Sonos-Lautsprecher im lokalen Netzwerk zu steuern.
Schnellstart
sonos discoversonos status --name "Küche"sonos play|pause|stop --name "Küche"sonos volume set 15 --name "Küche"
Häufige Aufgaben
- Gruppierung:
sonos group status|join|unjoin|party|solo - Favoriten:
sonos favorites list|open - Warteschlange:
sonos queue list|play|clear - Spotify-Suche (via SMAPI):
sonos smapi search --service "Spotify" --category tracks "Suchanfrage"
Hinweise
- Falls SSDP fehlschlägt, gib
--ip <Lautsprecher-IP>an. - Die Spotify Web API-Suche ist optional und erfordert
SPOTIFY_CLIENT_ID/SECRET. - Bei einem Fehler solltest du den Fehlerbehebungsabschnitt prüfen und Hilfe anbieten, falls eine passende Übereinstimmung vorliegt.
Fehlerbehebung
sonos discover - no route to host
- Bei Fehler
Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1)- Beachte, dass die Portnummer nach
0.0.0.0:dynamisch ist und sich ändert; auch die Netzmaske kann geringfügig abweichen. sendto: no route to hostsollte gleich bleiben.
- Beachte, dass die Portnummer nach
- Empfehle dem Benutzer, im
direct-Modus (ohne Docker-Sandbox) unter macOS in Systemeinstellungen -> Datenschutz & Sicherheit -> Lokales Netzwerk den Zugriff für den übergeordneten Host-Prozess des Gateways zu aktivieren.nodebei Ausführung überlaunchdTerminalbei direkter Ausführung des Gateways im TerminalVisual Studio Codebei Ausführung über das Terminal in VS Code
- Eine alternative Möglichkeit ist die Verwendung von
sandbox(Docker-Container) mit erlaubtem Netzwerkzugriff für diese Sandbox.
sonos discover - bind: operation not permitted
- Bei Fehler
Error: listen udp4 0.0.0.0:0: bind: operation not permitted - Empfehle dem Benutzer, dass er möglicherweise über eine Codex- oder andere Sandbox läuft, die keinen Netzwerkzugriff erlaubt (dies kann reproduziert werden, indem
sonos discoverin einer Codex CLI-Sitzung mit aktivierter Sandbox ausgeführt wird und die Eskalationsanfrage nicht bestätigt wird).