Documentación de MuPiBox MuPiBox NG

Spotify

Conectar Spotify con MuPiBox: crear una app Web API para catálogo y portadas, configurar la clave Soloist para la reproducción y añadir contenidos.

En MuPiBox, Spotify consta de dos partes separadas: el catálogo (búsqueda, álbumes, listas, portadas mediante la Web API de Spotify) y la reproducción (Spotify Connect en la caja). Ambas se configuran en Contenido → Proveedores y servicios → Spotify.

1. Catálogo: crear tu propia app Web API

  1. Inicia sesión en el Spotify Developer Dashboard con la cuenta que será propietaria de la app y crea una app con Web API.
  2. Introduce exactamente https://app.mupibox.de/oauth/spotify/callback/ como Redirect URI y guarda.
  3. Introduce el Client ID en la administración, elige el país y pulsa Conectar. Spotify se abre en una ventana nueva; tras autorizar, la confirmación vuelve automáticamente.

La caja usa PKCE: no se necesita ni se guarda ningún client secret. app.mupibox.de solo sirve como dirección de retorno HTTPS; los tokens se quedan en tu caja. Si el retorno automático no funciona, copia la dirección de callback completa del navegador en la administración mediante Retorno manual.

Para conectar otra cuenta de Spotify distinta de la propietaria, autorízala en el dashboard en Users Management.

2. Reproducción

BackendCaracterísticas
Spotify Soloist (predeterminado)motor de reproducción oficial de Spotify mediante PipeWire, funciona con Bluetooth. Necesita una clave API Soloist.
go-librespotalternativa sin clave Soloist, reproduce por ALSA: no funciona con auriculares ni altavoces Bluetooth. Solo para casos excepcionales.

El cambio de backend surte efecto tras un reinicio.

Clave API Soloist

  1. Abre la página oficial «Spotify Soloist API Key» (enlace en la administración) y crea una clave.
  2. Introdúcela en la administración. No es el Client ID de la Web API.
  3. Selecciona la caja una vez como dispositivo de reproducción en la app de Spotify; después aparece con su nombre.

Trata la clave Soloist como una contraseña. La caja vigila su vigencia de 90 días y descarga sola la versión actual del motor desde Spotify 14 días antes de que caduque.

Solicitudes y precarga

Spotify limita estrictamente el número de solicitudes. La caja se impone un límite muy bajo y guarda el catálogo en caché para no ser bloqueada. «Precargar todo» carga lentamente en segundo plano las listas de todos los contenidos de Spotify añadidos para que luego estén disponibles al instante. Si Spotify aun así informa de un bloqueo, la página muestra hasta cuándo la caja no enviará solicitudes.

Añadir contenidos

En Medios y categorías elige la fuente Spotify y busca artista, álbum, lista, programa/pódcast o pista. Los contenidos de Spotify también se pueden vincular a tarjetas RFID.

Interacciones

  • Sin internet, los contenidos de Spotify se ocultan en la página de inicio.
  • Si alguien inicia Spotify en la caja desde el móvil, el reproductor adopta esa reproducción; la reproducción local pausa Spotify y viceversa.
  • El control parental puede bloquear Spotify como fuente.