Music Assistant Jukebox Integration (Deprecated)

Notice: this integration is no longer actively being maintained.

Music Assistant now has a Plugin that should be used instead and offers much of the same features. See https://beta.music-assistant.io/plugins/party-mode/

---

A Home Assistant integration that provides a web-based song request system that integrates with Music Assistant to create an interactive jukebox experience for guests!

Features

• Real-time song search across all connected Music Assistant providers
• Minimalist responsive design with album artwork display
• Check what's Now Playing and Up Next in real time.
• No login required for guests, just share the URL
• Queue management through Home Assistant entities
• Auto queues a default party playlist when the request queue is empty
• Control queuing frequency (limit queue spamming)
• Access control through Home Assistant
• Auto revoking/creating access tokens for security

Head on over to Discussions / FeatureRequests if you want to request new features and general discussion!

Prerequisites

Before installing this integration, make sure you have:

• Home Assistant instance with Music Assistant integration
• Music Assistant Server Addon in Home Assistant (Separately hosted HA/MA instances may not work)
• A supported music provider configured in Music Assistant (e.g. Spotify, Apple Music, etc.)
• Media player entity configured in Home Assistant

Installation

HACS (Recommended)

or

• Add this repository to HACS as a custom repository
• HACS > Menu > Custom repositories
• URL: https://github.com/DJS91/HAMusicAssistantJukebox
• Category: Integration
• Click Install
• Restart Home Assistant

Manual Installation

• Download the latest release
• Copy the custom_components/music_assistant_jukebox folder to your Home Assistant custom_components folder
• Restart Home Assistant

Configuration

• Go to Settings > Devices & Services
• Click "Add Integration"
• Search for "Music Assistant Jukebox"
• Select your Music Assistant instance and media player entity
• Go to Settings > Automations & Scenes > + Create Automation
• Select "Music Assistant Jukebox Controller" from the list.
• Enter the same media player entity from Step 4 and enter the name of your default playlist from music assistant and click Save.

Usage

Switch on the jukebox using "JukeBox: Allow access" switch.

Access the jukebox via the new "Music Assistant Jukebox" Sidebar Panel OR

Scan the QR Code entity of choice OR

Access the jukebox interface directly at:

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

Entities

The integration adds these entities to Home Assistant:

Switches

• switch.jukebox_queue: Enable/disable queuing of songs (No manual control required. Managed by automation.)
• switch.jukebox_allow_access: Enable/disable access to the jukebox interface
• switch.music_assistant_jukebox_jukebox_play_music_on_start: Turn on/off if the default playlist plays automatically when the jukbox is turned on.

Number

• number.jukebox_queue_length: Shows current queue length (No manual adjustment required, Managed by automation)
• number.music_assistant_jukebox_jukebox_queuing_delay: Set a delay between song requests for guests (seconds) (0 = off)

Sensor

• music_assistant_jukebox_external_qr_code: External Jukebox UI Access QR code image for easy sharing on dashboards for users not on your network
• music_assistant_jukebox_internal_qr_code: Internal Jukebox UI Access QR code image for easy sharing for users on your network

Automation Blueprint

The integration includes an automation blueprint that handles:

• Queue length tracking
• Default playlist fallback
• Access control
• Media player control

To use the blueprint:

• Go to Settings > Automations & Scenes
• Click "+ Create Automation"
• Select "Music Assistant Jukebox Controller"
• Configure:
• Media Player: Select your Music Assistant media player
• Default Playlist: Enter the name of your fallback playlist

Credits

Big thanks to:

• OddPirate for their contrubutions to making this into an integration.
• PilaScat for their contributions to clean up, polish and UI improvements.

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