Spotify
Connecter Spotify à MuPiBox : créer une appli Web API pour le catalogue et les pochettes, configurer la clé Soloist pour la lecture et ajouter des contenus.
Sur MuPiBox, Spotify se compose de deux parties distinctes : le catalogue (recherche, albums, playlists, pochettes via la Web API de Spotify) et la lecture (Spotify Connect sur le boîtier). Les deux se configurent sous Contenus → Fournisseurs et services → Spotify.
1. Catalogue : créer votre propre appli Web API
- Connectez-vous au Spotify Developer Dashboard avec le compte qui doit posséder l'appli et créez une appli avec Web API.
- Saisissez exactement
https://app.mupibox.de/oauth/spotify/callback/comme Redirect URI et enregistrez. - Saisissez le Client ID dans l'administration, choisissez le pays et cliquez sur Connecter. Spotify s'ouvre dans une nouvelle fenêtre ; après autorisation, la confirmation revient automatiquement.
Le boîtier utilise PKCE : aucun client secret n'est nécessaire ni enregistré. app.mupibox.de sert uniquement d'adresse de retour HTTPS ; les jetons restent sur votre boîtier. Si le retour automatique ne fonctionne pas, copiez l'adresse de callback complète depuis le navigateur dans l'administration via Retour manuel.
Pour connecter un autre compte Spotify que celui du propriétaire de l'appli, autorisez-le dans le dashboard sous Users Management.
2. Lecture
| Backend | Caractéristiques |
|---|---|
| Spotify Soloist (par défaut) | moteur de lecture officiel de Spotify via PipeWire, fonctionne avec le Bluetooth. Nécessite une clé API Soloist. |
| go-librespot | alternative sans clé Soloist, joue via ALSA : ne fonctionne pas avec les casques ou enceintes Bluetooth. Uniquement pour les exceptions. |
Le changement de backend prend effet après un redémarrage.
Clé API Soloist
- Ouvrez la page officielle « Spotify Soloist API Key » (lien dans l'administration) et créez une clé.
- Saisissez-la dans l'administration. Ce n'est pas le Client ID de la Web API.
- Sélectionnez une fois le boîtier comme appareil de lecture dans l'appli Spotify ; il apparaît ensuite sous son nom.
Traitez la clé Soloist comme un mot de passe. Le boîtier surveille sa validité de 90 jours et télécharge lui-même la version actuelle du moteur chez Spotify 14 jours avant son expiration.
Requêtes et préchargement
Spotify limite strictement le nombre de requêtes. Le boîtier s'impose une limite très basse et met le catalogue en cache pour ne pas être bloqué. « Tout précharger » charge lentement en arrière-plan les listes de tous les contenus Spotify ajoutés pour qu'ils soient ensuite disponibles immédiatement. Si Spotify signale malgré tout un blocage, la page indique jusqu'à quand le boîtier n'envoie plus de requêtes.
Ajouter des contenus
Sous Médias et catégories, choisissez la source Spotify et cherchez un artiste, un album, une playlist, une émission/un podcast ou un titre. Les contenus Spotify peuvent aussi être associés à des cartes RFID.
Interactions
- Sans internet, les contenus Spotify sont masqués sur la page d'accueil.
- Si quelqu'un lance Spotify sur le boîtier depuis un téléphone, le lecteur reprend cette lecture ; la lecture locale met Spotify en pause et inversement.
- Le contrôle parental peut bloquer Spotify comme source.