Error while setting up jellyfin platform for media player

[owingst]

The problem

After restart, seeing this error in logs..

ERROR (MainThread) [homeassistant.components.media_player] Error while setting up jellyfin platform for media_player
Traceback (most recent call last):
File "/usr/src/homeassistant/homeassistant/helpers/entity_platform.py", line 366, in _async_setup_platform
await asyncio.shield(awaitable)
File "/usr/src/homeassistant/homeassistant/components/jellyfin/media_player.py", line 46, in async_setup_entry
handle_coordinator_update()
~~~~~~~~~~~~~~~~~~~~~~~~~^^
File "/usr/src/homeassistant/homeassistant/components/jellyfin/media_player.py", line 40, in handle_coordinator_update
entity: MediaPlayerEntity = JellyfinMediaPlayer(coordinator, session_id)
~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/src/homeassistant/homeassistant/components/jellyfin/media_player.py", line 60, in init
super().init(coordinator, session_id)
~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/src/homeassistant/homeassistant/components/jellyfin/entity.py", line 47, in init
self.device_name: str = self.session_data["DeviceName"]
~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^
KeyError: 'DeviceName'

I also found a comment on a possible related issue...

tep1997
25d

Receiving below error after latest HA Core update with the Jellyfin Integration.

Logger: homeassistant.helpers.frame
Source: helpers/frame.py:234
First occurred: 3:25:59 PM (9 occurrences)
Last logged: 3:56:35 PM

Detected code that calls async_forward_entry_setup for integration jellyfin with title: jellyfin and entry_id: XXXXXXXX, during setup without awaiting async_forward_entry_setup, which can cause the setup lock to be released before the setup is done. This will stop working in Home Assistant 2025.1, please report this issue.

Core: 2025.1.4
Supervisor: 2024.12.3
Operating System: 14.2
Frontend: 20250109.2

What version of Home Assistant Core has the issue?

2025.1.4

What was the last working version of Home Assistant Core?

No response

What type of installation are you running?

Home Assistant OS

Integration causing the issue

Jellyfin

Link to integration documentation on our website

https://www.home-assistant.io/integrations/jellyfin/

Diagnostics information

home-assistant_2025-01-30T17-37-05.611Z.log

Example YAML snippet

Anything in the logs that might be useful for us?

Just the error pasted above.

Additional information

No response

[home-assistant]

Hey there @j-stienstra, @ctalkington, mind taking a look at this issue as it has been labeled with an integration (jellyfin) you are listed as a code owner for? Thanks!

Code owner commands

Code owners of jellyfin can trigger bot actions by commenting:

• @home-assistant close Closes the issue.
• @home-assistant rename Awesome new title Renames the issue.
• @home-assistant reopen Reopen the issue.
• @home-assistant unassign jellyfin Removes the current integration label and assignees on the issue, add the integration domain after the command.
• @home-assistant add-label needs-more-information Add a label (needs-more-information, problem in dependency, problem in custom component) to the issue.
• @home-assistant remove-label needs-more-information Remove a label (needs-more-information, problem in dependency, problem in custom component) on the issue.

_{^{(message by CodeOwnersMention)}}

---

jellyfin documentation
jellyfin source
_{^{(message by IssueLinks)}}

[RunC0deRun]

Hi @owingst, thank you for reporting this.

I'm not seeing this message in my test instance, nor do I see where in the code we do not await this particular call, but I will look into it.

[owingst]

I updated HA to 2025.2, jellyfin error still there...removed jellyfin integration and errors went away. Reinstalled jellyfin integration and have the same error as before.

2025-02-06 11:46:36.928 ERROR (MainThread) [homeassistant.components.media_player] Error while setting up jellyfin platform for media_player: 'DeviceName'
Traceback (most recent call last):
  File "/usr/src/homeassistant/homeassistant/helpers/entity_platform.py", line 366, in _async_setup_platform
    await asyncio.shield(awaitable)
  File "/usr/src/homeassistant/homeassistant/components/jellyfin/media_player.py", line 46, in async_setup_entry
    handle_coordinator_update()
    ~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "/usr/src/homeassistant/homeassistant/components/jellyfin/media_player.py", line 40, in handle_coordinator_update
    entity: MediaPlayerEntity = JellyfinMediaPlayer(coordinator, session_id)
                                ~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/components/jellyfin/media_player.py", line 60, in __init__
    super().__init__(coordinator, session_id)
    ~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/src/homeassistant/homeassistant/components/jellyfin/entity.py", line 47, in __init__
    self.device_name: str = self.session_data["DeviceName"]
                            ~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^
KeyError: 'DeviceName'

Core: 2025.2.0
Supervisor: 2025.02.0
Operating System: 14.2
Frontend: 20250205.0

[RunC0deRun]

Hi @owingst,

I believe this issue is the same as you reported in #130467 . If that is the case, can you close that issue?

I've identified from your log that you have a device that does not have a DeviceName.
The media_player part of this integration requires a name to be assigned to a device.

The Jellyfin API indeed mentions that the DeviceName is optional.
I will make an adjustment to the integration that removes the dependency on DeviceName and optionally uses the DeviceId instead, which is not optional.

[owingst]

Sounds good to me. Thanks!