2025.3.4
首页 ▸ Integrations ▸

Jellyfin

The Jellyfin integration exposes a Jellyfin server as a media source in Home Assistant. Support is currently limited to music, movie and TV show libraries only. Other libraries will not appear in the media browser. This integration has been tested with Jellyfin server version 10.6.4 and later.

Additionally, this integration sets up every media session connected to the Jellyfin server as a media player in Home Assistant to provide media controls for each session.

Browsing media inside Home Assistant in a player’s context provides all libraries of type Movie and Series.

This integration also creates a Remote entity for sending remote commands to the client, if supported. For example, this can be used to tell the client to navigate right twice, down once, and select the focused item:

jellyfin_remote_script:
  alias: "Jellyfin Remote Script"
  sequence:
    - action: remote.send_command
      target:
        entity_id: remote.jellyfin_client
      data:
        delay_secs: 1.5
        command:
          - MoveRight
          - MoveRight
          - MoveDown
          - Select

配置

要将 Jellyfin service 添加到您的 Home Assistant 实例中，请使用此 My 按钮：

手动配置步骤

如果上述 My 按钮不起作用，您也可以手动执行以下步骤：

URL

The URL of the Jellyfin server. Please supply the full URL including the protocol and optional webroot. For example https://media.example.com, http://10.1.1.100:8096 or http://home.example.com/jellyfin.

Username

The Jellyfin user whose libraries you want to retrieve.

Password

The password of the supplied user.

选项

Jellyfin 的选项可以通过用户界面设置，具体步骤如下：

  • 浏览到您的 Home Assistant 实例。
  • 转到 设置 > 设备与服务。
  • 如果配置了多个 Jellyfin 实例，请选择您想配置的实例。
  • 选择集成，然后选择 配置。
Audio Codec

Sets the audio encoding codec to a Jellyfin API supported codec (aac, mp3, vorbis, wma)