Come configurare Spotify su Home Assistant

Come configurare Spotify su Home Assistant: guida per streaming musicale smart

Integrare Spotify con Home Assistant trasforma completamente l’esperienza musicale nella smart home, permettendo di controllare la riproduzione da automazioni, creare scenari personalizzati e gestire la musica in ogni stanza tramite dashboard unificata. A differenza del semplice controllo vocale con Alexa o Google Home, l’integrazione nativa di Spotify in Home Assistant offre automazioni avanzate come “avvia playlist relax quando entro in casa”, “pausa musica se squilla il citofono” o “sincronizza riproduzione multi-stanza”.

Questa guida completa ti accompagnerà attraverso tutti i passaggi necessari: dalla creazione dell’account sviluppatore Spotify, alla configurazione dell’integrazione in Home Assistant, fino alla realizzazione di automazioni musicali avanzate e controllo multi-dispositivo.


Prerequisiti necessari

Prima di iniziare, assicurati di avere:

  • Account Spotify attivo (Free o Premium – alcune funzioni richiedono Premium)

  • Home Assistant aggiornato (versione 2023.x o superiore consigliata)

  • Accesso completo alle impostazioni di Home Assistant

  • Browser web per configurare l’account sviluppatore Spotify

  • Dispositivi compatibili Spotify Connect (smartphone, smart speaker, Chromecast, computer)

Nota importante: con account Spotify Free puoi controllare la riproduzione su dispositivi già avviati, ma Spotify Premium è necessario per avviare la riproduzione da Home Assistant e controllare completamente dispositivi remoti.


Passo 1: Creare l’applicazione Spotify Developer

Per permettere a Home Assistant di comunicare con il tuo account Spotify, devi registrare un’applicazione sul portale sviluppatori Spotify e ottenere le credenziali API.

Procedura dettagliata:

  1. Vai sul sito Spotify for Developers

  2. Accedi con le tue credenziali Spotify esistenti

  3. Clicca su Create an App (Crea un’app)

  4. Compila il modulo di registrazione:

    • App name: “Home Assistant” (o nome a tua scelta)

    • App description: “Integrazione Home Assistant per controllo musicale”

    • Website: inserisci l’URL della tua istanza Home Assistant (es: https://tuohomeassistant.duckdns.org) o lascia vuoto

    • Redirect URI: questo è fondamentale! Inserisci:

      https://my.home-assistant.io/redirect/oauth

      oppure, se usi URL personalizzato:

      https://TUO_URL_HOME_ASSISTANT/auth/external/callback
  5. Accetta i termini di servizio e clicca su Create
  6. Una volta creata l’app, entrerai nella dashboard dell’applicazione
  7. Clicca su Show Client Secret per visualizzare il segreto client
  8. Annota immediatamente:

    • Client ID (visibile subito)

    • Client Secret (mostrato dopo aver cliccato sul pulsante)

Importante: conserva queste credenziali in modo sicuro, ti serviranno nel prossimo passaggio.


Passo 2: Configurare l’integrazione Spotify in Home Assistant

Home Assistant offre un’integrazione ufficiale Spotify che si configura tramite interfaccia grafica, senza dover modificare file YAML manualmente.

Metodo 1: Configurazione via interfaccia grafica (consigliato)

  1. Apri Home Assistant e vai su Impostazioni > Dispositivi e servizi

  2. Clicca sul pulsante + Aggiungi Integrazione in basso a destra

  3. Cerca “Spotify” nella barra di ricerca

  4. Seleziona l’integrazione Spotify ufficiale

  5. Inserisci le credenziali ottenute:

    • Client ID: copia-incolla dalla dashboard Spotify Developer

    • Client Secret: copia-incolla il segreto visualizzato

  6. Clicca su Invia

  7. Verrai reindirizzato alla pagina di autenticazione Spotify

  8. Accedi con il tuo account Spotify e autorizza Home Assistant ad accedere ai dati del tuo account

  9. Dopo l’autorizzazione, verrai reindirizzato a Home Assistant

  10. L’integrazione Spotify sarà ora configurata e attiva

Verifica installazione:

  • Vai su Impostazioni > Dispositivi e servizi > Spotify

  • Dovresti vedere l’entità media player media_player.spotify_TUONOME creata automaticamente

Metodo 2: Configurazione YAML (opzionale, per utenti avanzati)

Se preferisci configurare manualmente, aggiungi al file configuration.yaml:

spotify:
  client_id: TUO_CLIENT_ID
  client_secret: TUO_CLIENT_SECRET

Salva il file e riavvia Home Assistant. Al primo accesso dovrai completare l’autenticazione OAuth tramite browser come nel metodo 1.


Passo 3: Configurare dispositivi Spotify Connect

Affinché Home Assistant possa controllare la riproduzione musicale, devi avere almeno un dispositivo compatibile Spotify Connect attivo.

Dispositivi supportati:

  • Smartphone e tablet con app Spotify installata

  • Smart speaker (Amazon Echo, Google Home, Sonoff con Alexa)

  • Chromecast Audio e Chromecast TV

  • Computer con app desktop Spotify

  • Smart TV con app Spotify integrata

  • Amplificatori e receiver con Spotify Connect (Yamaha MusicCast, Sonos, ecc.)

  • Raspberry Pi con software Raspotify o Mopidy

Nota: i dispositivi Spotify Connect devono essere sulla stessa rete WiFi di Home Assistant (o raggiungibili via Internet se hai configurato accesso esterno).


Passo 4: Controllare Spotify da Home Assistant

Una volta configurata l’integrazione, puoi controllare Spotify da diverse interfacce.

Dashboard Lovelace:

Home Assistant crea automaticamente una card media player per Spotify.

  1. Vai alla Dashboard principale

  2. Clicca sui tre puntini in alto a destra > Modifica dashboard

  3. Clicca su + Aggiungi card

  4. Cerca Media Control (Controllo multimediale)

  5. Seleziona l’entità media_player.spotify_TUONOME

  6. Salva la card

Ora puoi:

  • Vedere la copertina dell’album in riproduzione

  • Play/pausa/avanti/indietro

  • Regolare volume

  • Selezionare dispositivo di output Spotify Connect

  • Sfogliare playlist e album (con Spotify Premium)

Controllo da Strumenti per Sviluppatori:

Per test rapidi:

  1. Vai su Strumenti per Sviluppatori > Servizi

  2. Seleziona media_player.play_media

  3. Compila i campi:

    entity_id: media_player.spotify_TUONOME
    media_content_type: playlist
    media_content_id: spotify:playlist:37i9dQZF1DXcBWIGoYBM5M
  4. Clicca CHIAMA SERVIZIO

La playlist Spotify inizierà la riproduzione sul dispositivo selezionato.

Passo 5: Creare automazioni musicali avanzate

L’integrazione Spotify permette automazioni potenti e creative.

Esempio 1: Avvia playlist quando entri in casa

automation:
  - alias: "Musica benvenuto"
    trigger:
      platform: state
      entity_id: person.tuo_nome
      to: "home"
    condition:
      condition: time
      after: "18:00:00"
      before: "23:00:00"
    action:
      - service: media_player.play_media
        target:
          entity_id: media_player.spotify_tuo_nome
        data:
          media_content_type: playlist
          media_content_id: "spotify:playlist:37i9dQZF1DX4WYpdgoIcn6"
      - service: media_player.volume_set
        target:
          entity_id: media_player.spotify_tuo_nome
        data:
          volume_level: 0.3

Questa automazione avvia una playlist chill quando torni a casa dopo le 18:00, con volume al 30%.

Esempio 2: Pausa musica quando squilla il citofono

automation:
  - alias: "Pausa musica per citofono"
    trigger:
      platform: state
      entity_id: binary_sensor.campanello_ingresso
      to: "on"
    action:
      - service: media_player.media_pause
        target:
          entity_id: media_player.spotify_tuo_nome

Esempio 3: Playlist sveglia graduale

automation:
  - alias: "Sveglia con musica graduale"
    trigger:
      platform: time
      at: "07:00:00"
    action:
      - service: media_player.volume_set
        target:
          entity_id: media_player.spotify_camera
        data:
          volume_level: 0.1
      - service: media_player.play_media
        target:
          entity_id: media_player.spotify_camera
        data:
          media_content_type: playlist
          media_content_id: "spotify:playlist:37i9dQZF1DX0h6FQn5HjVy"
      - delay: "00:05:00"
      - service: media_player.volume_set
        target:
          entity_id: media_player.spotify_camera
        data:
          volume_level: 0.3

Volume iniziale basso che aumenta dopo 5 minuti per sveglia più naturale.

Esempio 4: Playlist cena automatica

automation:
  - alias: "Musica per cena"
    trigger:
      platform: time
      at: "19:30:00"
    condition:
      - condition: state
        entity_id: binary_sensor.presenza_casa
        state: "on"
    action:
      - service: media_player.play_media
        target:
          entity_id: media_player.spotify_cucina
        data:
          media_content_type: playlist
          media_content_id: "spotify:playlist:37i9dQZF1DWZeKCadgRdKQ"

Passo 6: Trovare gli ID di playlist, album e tracce Spotify

Per le automazioni, hai bisogno degli Spotify URI (identificatori univoci).

Come trovare gli URI:

  1. Apri l’app Spotify su smartphone o desktop

  2. Vai alla playlist, album o traccia desiderata

  3. Clicca sui tre puntini > Condividi > Copia link Spotify

  4. Il link sarà tipo:

    https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M
  5. Converti in URI sostituendo:
    spotify:playlist:37i9dQZF1DXcBWIGoYBM5M

Formato URI:

  • Playlist: spotify:playlist:ID

  • Album: spotify:album:ID

  • Traccia: spotify:track:ID

  • Artista: spotify:artist:ID


Passo 7: Riproduzione multi-stanza sincronizzata

Con Spotify Connect puoi trasferire la riproduzione tra dispositivi o sincronizzare più speaker.

Trasferire riproduzione:

service: media_player.select_source
target:
  entity_id: media_player.spotify_tuo_nome
data:
  source: "Soggiorno Speaker"

Nota su multi-room:

Spotify Connect nativamente non supporta sincronizzazione multi-stanza come Chromecast o Sonos. Per audio sincronizzato in più stanze, considera:

  • Chromecast Audio Groups con Spotify

  • Sonos system con integrazione Spotify

  • Snapcast per sincronizzazione forzata su Raspberry Pi


Limitazioni da conoscere

Con Spotify Free:

  • Non puoi avviare riproduzione da Home Assistant

  • Puoi solo controllare (pausa, skip) riproduzione già avviata manualmente

  • Pubblicità interrompe le automazioni

Con Spotify Premium:

  • Controllo completo da Home Assistant

  • Avvio playlist, album, tracce

  • Nessuna pubblicità

  • Qualità audio superiore

Altre limitazioni:

  • Spotify Connect richiede che almeno un dispositivo sia già connesso e visibile

  • Non puoi leggere cronologia ascolti dettagliata (privacy Spotify)

  • Rate limiting API: troppe richieste in poco tempo possono causare blocchi temporanei


Risoluzione problemi comuni

Integrazione non si connette:

  • Verifica Client ID e Client Secret corretti

  • Controlla Redirect URI configurato correttamente su Spotify Developer

  • Riavvia Home Assistant dopo modifica configurazione

Dispositivi non visibili:

  • Assicurati che almeno un dispositivo Spotify Connect sia attivo sulla rete

  • Apri app Spotify e avvia manualmente una riproduzione, poi controlla Home Assistant

Automazioni non funzionano:

  • Verifica di avere Spotify Premium attivo

  • Controlla URI playlist/album corretti

  • Testa manualmente il servizio da Strumenti per Sviluppatori

Errore “Entity not available”:

  • Ricarica integrazione Spotify da Impostazioni > Dispositivi e servizi

  • Verifica connessione Internet Home Assistant


Consigli avanzati e best practices

  • Crea scene musicali per diversi momenti della giornata (mattino energico, pomeriggio lavoro, sera relax)

  • Usa condizioni meteo per playlist adattive (pioggia → musica rilassante)

  • Integra con sensori presenza per musica solo se qualcuno è in stanza

  • Backup delle automazioni musicali in file YAML separati per gestione modulare

  • Usa input_select per scegliere playlist da dashboard senza modificare automazioni