Issues viewing images? Read this first.

[droans]

Background

This issue solely affects local providers (eg, Plex, Filesystem, Jellyfin, etc.). If you are not using a local provider, please create a new issue.

For the action mass_queue.get_queue_items, this integration reaches out to Music Assistant and asks for the queue data. This is returned in a (much longer) version of the format below:

[
    {
        "queue_id": "d8:3a:dd:29:33:52",
        "queue_item_id": "02fbc6f1173342538198b137c4a73b19",
        "name": "Halsey - Nightmare",
        "duration": 232,
        "sort_index": 3,
        ...
        "image": {
            "type": "thumb",
            "path": "https://resources.tidal.com/images/e522ef7e/0e06/450b/936a/74059a3f20b4/750x750.jpg",
            "provider": "tidal",
            "remotely_accessible": true
        },
        "index": 0,
        "available": true
    }
    ...
]

This integration will filter the data and select the image URL from the path above. However, for local hosts, this image path will often point either at a relative path on the drive (eg, artist/album/cover.png) or at a local path (eg, 192.168.1.2:1234/media/images/artist/album/cover.png).

This is problematic for a couple of reasons. Relative drive paths can almost never be accessed, even from the same machine. Local paths can't be accessed outside of your local network and, if you are using HTTPS to access Home Assistant, they can never be displayed.

However, Music Assistant allows for metadata providers. These, in theory, should fill in this missing data.

How to Help

Helping fill out this data is rather straightforward:

1. Start a queue on one of your media players. Ensure it is not displaying any images.
2. In Home Assistant, Navigate to the Developer Tools section and click on Template. Paste the below template, replacing YOUR_MASS_PLAYER with the Entity ID of the player:

{% set player = 'media_player.YOUR_MASS_PLAYER' %}
{{ state_attr(player, 'active_queue') }}

Copy the output. You'll need it for the next step.

3. Navigate to the "Actions" tab and fill out the action form as below. Replace YOUR_QUEUE_ID with the output from Step 2 and YOUR_CONFIG_ENTRY with the Music Assistant Queue Actions entry that you use.

• Action: mass_queue.send_command
• Command: player_queues/items
• Data:

queue_id: YOUR_QUEUE_ID
limit: 10

• Config Entry ID: YOUR_CONFIG_ENTRY

4. Press "Perform Action". Copy the response output and save it to a text file.

5. Reply to this issue using the template below. Upload the saved file to your issue.

---

Home Assistant Version: <Get this information from Settings - About>
Music Assistant Queue Actions Version: <Get this information from Settings - Devices & Services - Music Assistant Queue Actions>
Music Assistant Version: <Get this information from Music Assistant Settings - Core>
Music Providers: <Get this information from Music Assistant Settings - Music providers>
Metadata Providers: <Get this information from Music Assistant Settings - Metadata providers>
How often does this issue occur - every track, most tracks, some tracks, or only a few tracks?
Any other issues, questions, comments, or notes?

---

---

You can also further help by testing v0.6.2 - this update checks the different image keys for each item and uses the first which returns a URL which Music Assistant deemed to be accessible. Please note that this will not fix every instance - only those where the various providers were able to pull web-accessible images.

[igalg99]

Hope it helps.

Home Assistant Version: 2025.09.0
Music Assistant Queue Actions Version: Version 0.6.1
Music Assistant Version: 2.6.0
Music Providers: Filesystem (remote share) [music], Music Assistant, RadioBrowser, Tune-In Radio
Metadata Providers: fanart.tv, LRCLIB, MusicBrainz, The Audio DB
How often does this issue occur - it shows in the main player but it doest show in the queue . also in the new global search function (awesome by the way) , no images shown.

mass_items_queue.txt

[hrpaperstacks69]

Home Assistant Version: 2025.10.0

output.txt

Music Assistant Queue Actions Version: Version 0.6.1

Music Assistant Version: 2.6.0

Music Providers: Filesystem (localdisk)

Metadata Providers: fanart.tv (though i have 'cover.jpg' in the album level local folder containing each of the tracks)

How often does this issue occur - every track on the queue, most tracks on the player

Any other issues, questions, comments, or notes?

these tracks all display the cover.jpg local image when the track is searched or played in the naive music assistant GUI.

[droans]

@igalg99 - Please test out v0.6.2 and let me know if you see images for at least some of your media.

@hrpaperstacks69 - Unfortunately, it doesn't look like any of your items have images present. You may want to enable more metadata providers.

Until Music Assistant changes their strategy and pulls metadata for all items (or at least those with no images or local only images), we won't be able to pull everything unfortunately.

[igalg99]

Tried it. But it doesn't load after I upgrade to 0.6.2. here is the error log

Logger: homeassistant.setup
Source: setup.py:343
First occurred: 23:32:30 (1 occurrence)
Last logged: 23:32:30

Setup failed for custom integration 'mass_queue': Unable to import component: No module named 'custom_components.mass_queue.util'
Traceback (most recent call last):
File "/usr/src/homeassistant/homeassistant/setup.py", line 343, in _async_setup_component
component = await integration.async_get_component()
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/src/homeassistant/homeassistant/loader.py", line 1026, in async_get_component
self._component_future.result()
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^
File "/usr/src/homeassistant/homeassistant/loader.py", line 1006, in async_get_component
comp = await self.hass.async_add_import_executor_job(
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
self._get_component, True
^^^^^^^^^^^^^^^^^^^^^^^^^
)
^
File "/usr/local/lib/python3.13/concurrent/futures/thread.py", line 59, in run
result = self.fn(*self.args, **self.kwargs)
File "/usr/src/homeassistant/homeassistant/loader.py", line 1066, in _get_component
ComponentProtocol, importlib.import_module(self.pkg_path)
~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^
File "/usr/src/homeassistant/homeassistant/util/loop.py", line 201, in protected_loop_func
return func(*args, **kwargs)
File "/usr/local/lib/python3.13/importlib/init.py", line 88, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "", line 1387, in _gcd_import
File "", line 1360, in _find_and_load
File "", line 1331, in _find_and_load_unlocked
File "", line 935, in _load_unlocked
File "", line 1026, in exec_module
File "", line 488, in _call_with_frames_removed
File "/config/custom_components/mass_queue/init.py", line 24, in
from .actions import (
...<3 lines>...
)
File "/config/custom_components/mass_queue/actions.py", line 60, in
from .util import find_image
ModuleNotFoundError: No module named 'custom_components.mass_queue.util'

[droans]

@igalg99 @hrpaperstacks69

Please try v0.7.0-b4+ with Music Assistant Player Card v1.1.0-b25+.

[YassineOuamer]

Home Assistant Version: 2025.11.0
Music Assistant Queue Actions Version: 0.7.0
Music Assistant Version: 2.6.1
Music Providers: Jellyfin Media Server Library
Metadata Providers: Fanart.tv, LRCLIB, MusicBrainz, The Audio DB
How often does this issue occur - every track, most tracks, some tracks, or only a few tracks? It happens for all tracks.

mass_queue_log.txt

[Gurutasker]

Home Assistant Version: 2025.12.5
Music Assistant Queue Actions Version: 0.10.0 (Downloaded v0.10.1-b.0)
Music Assistant Version: 2.7.3 (Player card version v2.5.0-b.23)
Music Providers: Filesystem (local disk), Music Assistant, RadioBrowser
Metadata Providers: fanart.tv, LRCLIB, MusicBrainz, The Audio DB
How often does this issue occur - every track, most tracks, some tracks, or only a few tracks?

• Image showing on player view, but album art not showing in Queue.

mass_queue_log.txt

[droans]

@Gurutasker have you enabled fallback support in the integration options? You can do so by going to the Music Assistant Queue Actions integration page in your HA settings and clicking the cog button.

[Gurutasker]

@droans - Yes, that works but has too hard a performance hit which impacted streaming. Had thought this may contribute to finding ways to not use fallback. Appreciate the support.

[howels]

Not sure I had this right before but I seem to be stuck with the same image regardless of whether I toggle fallback support or not. Images render correct for the now-playing item via the imageproxy in MASS but the queue seems to fail. It works in the dedicated MASS web player but not here:

I see the following style of content all the time:

    image:
      type: thumb
      path: /library/metadata/268642/thumb/1728485298
      provider: plex--KLtCEeU7
      remotely_accessible: false

Checking or unchecking "Attempt fallback support" doesn't appear to change this behaviour.