Skip to content

Jellyfin

A library provider for Jellyfin.

https://github.com/anibridge/anibridge-jellyfin-provider

Configuration

library_provider_config:
  jellyfin:
    url: ...
    token: ...
    user: ...
    # sections: []
    # genres: []
    # strict: true

url

str (required)

The base URL of the Jellyfin server (e.g., http://localhost:8096).

token

str (required)

The Jellyfin API token. You can generate this under your user settings in the Jellyfin admin dashboard.

Danger

The token is sensitive and should be kept secret. Do not share it or expose it publicly, as it can be used to access and modify your Jellyfin server.

user

str (required)

The Jellyfin user to synchronize. This can be a user id, username, or display name.

sections

list[str] (optional, default: [])

A list of Jellyfin library section names to constrain synchronization to. Leave empty/unset to include all sections.

genres

list[str] (optional, default: [])

A list of genres to constrain synchronization to. Leave empty/unset to include all genres.

strict

bool (optional, default: True)

When enabled, show/season/episode mappings are restricted to the section's highest-priority TV show metadata downloader from Jellyfin library options. For example, if the top TV metadata downloader is AniDB, only AniDB mapping descriptors will be considered for matching. When disabled, all metadata downloaders will be considered for matching. This option is enabled by default.

Webhooks

The Jellyfin provider supports webhooks for automatic synchronization on activity. To set up webhooks, install and configure the jellyfin-plugin-webhook.

Use the 'Generic Webhook' type and set the URL to:

http://<your-server-host>:<port>/webhook/jellyfin

Configure the following settings:

  • Notification Type: 'Item Added', 'Playback Stop', 'User Data Saved'
  • Item Type: 'Movies', 'Episodes', 'Seasons', 'Series', 'Send All Properties'
  • User Filter: (optional) restrict to specific users by username or user id

User Filter

If you have multiple users, you can use the 'User Filter' to prevent unecessary webhooks from being sent for other users. Not doing so won't change functionality, but may result in more webhooks being sent than necessary and thus more load on the server.