sonoscli

Sonos CLI

Use sonos para controlar alto-falantes Sonos na rede local.

Início rápido

• sonos discover
• sonos status --name "Cozinha"
• sonos play|pause|stop --name "Cozinha"
• sonos volume set 15 --name "Cozinha"

Tarefas comuns

• Agrupamento: sonos group status|join|unjoin|party|solo
• Favoritos: sonos favorites list|open
• Fila: sonos queue list|play|clear
• Pesquisa no Spotify (via SMAPI): sonos smapi search --service "Spotify" --category tracks "consulta"

Observações

• Se o SSDP falhar, especifique --ip <ip-do-alto-falante>.
• A pesquisa via Spotify Web API é opcional e requer SPOTIFY_CLIENT_ID/SECRET.
• Se houver um erro, verifique a seção de solução de problemas e ofereça conselhos se houver uma correspondência razoável.

Solução de problemas

sonos discover - no route to host

• No erro Error: write udp4 0.0.0.0:64326->239.255.255.250:1900: sendto: no route to host (Command exited with code 1)
  • Note que o número da porta após 0.0.0.0: é efêmero e mudará, e a máscara de rede pode não corresponder exatamente
  • A mensagem sendto: no route to host deve permanecer consistente
• Aconselhe o usuário que, no modo direct (sem sandbox Docker) no Mac OS, será necessário ativar Settings -> Privacy & Security -> Local Network para o processo pai de nível superior do Gateway
  • node se estiver rodando via launchd
  • Terminal se estiver rodando o gateway diretamente no terminal
  • Visual Studio Code se estiver rodando via terminal no VS Code
• Uma opção alternativa é usar sandbox (contêiner Docker) com acesso à rede permitido para aquele sandbox

sonos discover - bind: operation not permitted

• No erro Error: listen udp4 0.0.0.0:0: bind: operation not permitted
• Aconselhe o usuário que ele pode estar rodando via um sandbox do Codex ou outro que não permite acesso à rede (isso pode ser replicado rodando sonos discover dentro de uma sessão do Codex CLI com sandbox ativado e sem aprovar a solicitação de escalonamento)