📋

Sonoscli

Controle caixas de som Sonos pela linha de comando — descubra dispositivos, gerencie reprodução, ajuste volume e organize grupos.

Peter Steinbergerv1.0.0
Productivity & TasksProductivityOpen SourceAutomationCLIDeveloper Tool
Conectando à VM...
Conectando à VM...
npx clawhub@latest install sonoscli
5Instalações atuais
1.3kTotal de instalações
v1.0.0Versão

Requisitos

Spotify API Credentials(optional)
Ver código-fonte(ClawHub)
  • Descobrir alto-falantes — Encontra automaticamente todos os dispositivos Sonos na rede local via SSDP.
  • Controle de reprodução — Reproduzir, pausar ou parar qualquer alto-falante pelo nome.
  • Gerenciamento de volume — Definir níveis de volume precisos em alto-falantes individuais.
  • Controle de grupo — Juntar-se, sair, modo festa ou colocar alto-falantes em solo com comandos simples.
  • Favoritos e fila — Navegar e reproduzir favoritos do Sonos, e gerenciar a fila de reprodução.
  • Pesquisa do Spotify — Pesquisar faixas do Spotify via SMAPI (requer credenciais opcionais do Spotify).

Como funciona

1

Step 1

Instalar o CLI
O binário sonos é instalado via Go e se comunica diretamente com os alto-falantes Sonos pela rede local.
2

Step 2

Descobrir dispositivos
Executar sonos discover para encontrar todos os alto-falantes usando multicast SSDP. Se o SSDP falhar, especifique o IP do alto-falante diretamente com --ip.
3

Step 3

Executar comandos
Direcionar um alto-falante pelo nome usando --name e emitir comandos de reprodução, volume ou grupo.
4

Step 4

Integração opcional com Spotify
Fornecer variáveis de ambiente SPOTIFY_CLIENT_ID e SPOTIFY_CLIENT_SECRET para habilitar a pesquisa do Spotify via protocolo SMAPI.

Principais funcionalidades

Zero dependência de nuvem
Comunica-se diretamente com os alto-falantes Sonos na rede local; nenhuma conta Sonos necessária para uso básico.
Seleção de alto-falante por nome
Usar --name "Nome da sala" para direcionar qualquer alto-falante pelo seu rótulo de sala Sonos.
Gerenciamento de grupos
Ciclo de vida completo do grupo: verificar status, juntar-se, sair, modo festa e solo.
Controle de fila
Listar, reproduzir e limpar a fila de reprodução.
Reprodução de favoritos
Listar e abrir favoritos do Sonos pelo CLI.
Pesquisa Spotify SMAPI
Pesquisar conteúdo do Spotify sem sair do terminal (credenciais opcionais necessárias).

Requisitos

Alto-falantes Sonos
Um ou mais dispositivos Sonos na mesma rede local que a máquina executando o CLI.
Toolchain Go
Necessária para instalar o binário sonos via go install.
Acesso à rede
O multicast SSDP deve ser acessível; caso contrário, use --ip <speaker-ip> como fallback.
Credenciais do Spotify (opcional)
SPOTIFY_CLIENT_ID e SPOTIFY_CLIENT_SECRET são necessários apenas para a pesquisa Spotify SMAPI.

Casos de uso

Scripts de automação residencial
Acionar reprodução de música, ajustar volume ou silenciar alto-falantes como parte de scripts shell ou tarefas cron.
Integração com assistente de IA
Permitir que Clawdbot controle seus alto-falantes Sonos via comandos de linguagem natural.
Rotinas matinais/noturnas
Automatizar agrupamento de alto-falantes e níveis de volume em horários definidos.
Ambientes de desenvolvimento
Silenciar ou controlar rapidamente alto-falantes sem sair do terminal durante sessões de trabalho focado.

Como instalar

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

Perguntas frequentes

Avaliações

0 avaliações

Faça login para escrever uma avaliação

Nenhuma avaliação ainda. Seja o primeiro a compartilhar sua experiência!