Integración Music Assistant Jukebox (Obsoleta)

Aviso: esta integración ya no se mantiene activamente.

Music Assistant ahora tiene un Plugin que debe usarse en su lugar y ofrece muchas de las mismas funciones. Vea https://beta.music-assistant.io/plugins/party-mode/

---

Una integración de Home Assistant que proporciona un sistema de solicitud de canciones basado en la web que se integra con Music Assistant para crear una experiencia de jukebox interactiva para los invitados.

Funciones

• Búsqueda de canciones en tiempo real en todos los proveedores de Music Assistant conectados
• Diseño minimalista y responsive con visualización de la portada del álbum
• Consulta lo que se está reproduciendo y lo siguiente en tiempo real.
• No se requiere inicio de sesión para los invitados, solo comparte la URL
• Gestión de la cola mediante entidades de Home Assistant
• Cola automática de una lista de reproducción predeterminada para la fiesta cuando la cola de solicitudes está vacía
• Control de la frecuencia de las colas (limita el spam en la cola)
• Control de acceso a través de Home Assistant
• Revocación/creación automática de tokens de acceso por seguridad

Dirígete a Discusiones / Solicitudes de Funciones si quieres solicitar nuevas funciones o para discusión general.

Requisitos previos

Antes de instalar esta integración, asegúrate de tener:

• Instancia de Home Assistant con la integración Music Assistant
• Complemento Music Assistant Server en Home Assistant (Instancias HA/MA alojadas por separado pueden no funcionar)
• Un proveedor de música compatible configurado en Music Assistant (por ejemplo, Spotify, Apple Music, etc.)
• Entidad de reproductor multimedia configurada en Home Assistant

Instalación

HACS (Recomendado)

o

• Añade este repositorio a HACS como un repositorio personalizado
• HACS > Menú > Repositorios personalizados
• URL: https://github.com/DJS91/HAMusicAssistantJukebox
• Categoría: Integración
• Haz clic en Instalar
• Reinicia Home Assistant

Instalación Manual

• Descarga la última versión
• Copia la carpeta custom_components/music_assistant_jukebox en la carpeta custom_components de tu Home Assistant
• Reinicia Home Assistant

Configuración

• Ve a Configuración > Dispositivos y Servicios
• Haz clic en "Agregar Integración"
• Busca "Music Assistant Jukebox"
• Selecciona tu instancia de Music Assistant y la entidad del reproductor multimedia
• Ve a Configuración > Automatizaciones y Escenas > + Crear Automatización
• Selecciona "Controlador Music Assistant Jukebox" de la lista.
• Introduce la misma entidad del reproductor multimedia del Paso 4 e ingresa el nombre de tu lista de reproducción predeterminada de Music Assistant y haz clic en Guardar.

Uso

Enciende el jukebox usando el interruptor "JukeBox: Permitir acceso".

Accede al jukebox a través del nuevo Panel Lateral "Music Assistant Jukebox" O

Escanea la entidad del Código QR que prefieras O

Accede directamente a la interfaz del jukebox en:

http://homeassistant:8123/local/jukebox/jukebox.html

Entidades

La integración añade estas entidades a Home Assistant:

Interruptores

• switch.jukebox_queue: Activar/desactivar la cola de canciones (No se requiere control manual. Gestionado por automatización.)
• switch.jukebox_allow_access: Activar/desactivar el acceso a la interfaz del jukebox
• switch.music_assistant_jukebox_jukebox_play_music_on_start: Activar/desactivar si la lista de reproducción predeterminada se reproduce automáticamente al encender el jukebox.

Número

• number.jukebox_queue_length: Muestra la longitud actual de la cola (No se requiere ajuste manual, gestionado por automatización)
• number.music_assistant_jukebox_jukebox_queuing_delay: Establece un retraso entre las solicitudes de canciones para invitados (segundos) (0 = desactivado)

Sensor

• music_assistant_jukebox_external_qr_code: Código QR de acceso a la interfaz externa del Jukebox para compartir fácilmente en paneles con usuarios que no estén en tu red
• music_assistant_jukebox_internal_qr_code: Código QR de acceso a la interfaz interna del Jukebox para compartir fácilmente con usuarios en tu red

Plano de Automatización

La integración incluye un plano de automatización que gestiona:

• Seguimiento de la longitud de la cola
• Reproducción de lista predeterminada como respaldo
• Control de acceso
• Control del reproductor multimedia

Para usar el plano:

• Ve a Configuración > Automatizaciones y Escenas
• Haz clic en "+ Crear Automatización"
• Selecciona "Controlador de Jukebox de Music Assistant"
• Configura:
• Reproductor Multimedia: Selecciona tu reproductor multimedia de Music Assistant
• Lista Predeterminada: Ingresa el nombre de tu lista de reproducción de respaldo

Créditos

Un gran agradecimiento a:

• OddPirate por sus contribuciones para convertir esto en una integración.
• PilaScat por sus contribuciones en limpieza, pulido y mejoras de la interfaz.

--- Tranlated By Open Ai Tx | Last indexed: 2026-04-14 ---