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:
-
Vai sul sito Spotify for Developers
-
Accedi con le tue credenziali Spotify esistenti
-
Clicca su Create an App (Crea un’app)
-
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
-
- Accetta i termini di servizio e clicca su Create
- Una volta creata l’app, entrerai nella dashboard dell’applicazione
- Clicca su Show Client Secret per visualizzare il segreto client
-
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)
-
Apri Home Assistant e vai su Impostazioni > Dispositivi e servizi
-
Clicca sul pulsante + Aggiungi Integrazione in basso a destra
-
Cerca “Spotify” nella barra di ricerca
-
Seleziona l’integrazione Spotify ufficiale
-
Inserisci le credenziali ottenute:
-
Client ID: copia-incolla dalla dashboard Spotify Developer
-
Client Secret: copia-incolla il segreto visualizzato
-
-
Clicca su Invia
-
Verrai reindirizzato alla pagina di autenticazione Spotify
-
Accedi con il tuo account Spotify e autorizza Home Assistant ad accedere ai dati del tuo account
-
Dopo l’autorizzazione, verrai reindirizzato a Home Assistant
-
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_TUONOMEcreata 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.
-
Vai alla Dashboard principale
-
Clicca sui tre puntini in alto a destra > Modifica dashboard
-
Clicca su + Aggiungi card
-
Cerca Media Control (Controllo multimediale)
-
Seleziona l’entità
media_player.spotify_TUONOME -
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:
-
Vai su Strumenti per Sviluppatori > Servizi
-
Seleziona
media_player.play_media -
Compila i campi:
entity_id: media_player.spotify_TUONOME media_content_type: playlist media_content_id: spotify:playlist:37i9dQZF1DXcBWIGoYBM5M
- 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:
-
Apri l’app Spotify su smartphone o desktop
-
Vai alla playlist, album o traccia desiderata
-
Clicca sui tre puntini > Condividi > Copia link Spotify
-
Il link sarà tipo:
https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M
- 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
