Documentation Index
Fetch the complete documentation index at: https://mintlify.com/chrisbenincasa/tunarr/llms.txt
Use this file to discover all available pages before exploring further.
Tunarr can source content from one or more Jellyfin servers. All metadata — titles, artwork, episode details, and more — is read directly from Jellyfin. Once connected, you can browse your Jellyfin libraries when building channel schedules and freely combine Jellyfin content with other media sources.
Connecting a Jellyfin Server
To add a Jellyfin server, navigate to Settings > Sources in the Tunarr web UI, click Add, and choose Jellyfin. You will be presented with a dialog to enter the connection details. Tunarr supports two authentication methods: API key and username/password.
Open Media Sources settings
In the Tunarr web UI, navigate to Settings > Sources.
Click Add and select Jellyfin
Click the Add button in the Media Sources toolbar, then select Jellyfin from the dropdown.
Enter the server URL
In the Add Jellyfin Media Source dialog, enter the full URL of your Jellyfin server, including the port if applicable (for example, http://192.168.1.100:8096).
Choose an authentication method
Tunarr supports two ways to authenticate with Jellyfin: API Key (Recommended)
Username and Password
The recommended approach is to generate a dedicated API key for Tunarr in the Jellyfin admin dashboard.
- In Jellyfin, go to Admin Dashboard > API Keys.
- Click New API Key and give it a name (for example, “Tunarr”).
- Copy the generated key and paste it into the API Key field in the Tunarr dialog.
Using a dedicated API key makes it easy to revoke Tunarr’s access independently of your account credentials. If you are not a Jellyfin admin — or simply prefer not to use an API key — you can authenticate with your Jellyfin username and password.Tunarr does not persist your Jellyfin password. It sends a one-time request to the Jellyfin API to exchange your username and password for an API key, and only that resulting API key is stored in the Tunarr database.
Save and confirm
Click Save. If the server is reachable and the credentials are valid, the Jellyfin server will appear in the Media Sources table.
Library Synchronization
After connecting your Jellyfin server, you can configure Tunarr to periodically import metadata from your Jellyfin libraries. This is strictly a one-way sync — Tunarr reads data from Jellyfin and never modifies or deletes anything on your Jellyfin server.
Library synchronization is an alpha-only feature planned for general availability in v1.0. Synced metadata enables richer search and scheduling inside Tunarr.
Open the Edit Libraries dialog
In the Media Sources table, find your Jellyfin server and click the Edit Libraries button.
Select libraries to sync
You will see a list of all Jellyfin libraries available to Tunarr. Enable each library you want Tunarr to synchronize.
Wait for the initial sync
Enabled libraries are queued for synchronization immediately. Tunarr processes one library per source at a time.
Streaming from Disk
For the best streaming performance, Tunarr should have direct access to the media files on disk rather than fetching them through Jellyfin over the network. There are two ways to set this up.
The simplest approach is to ensure Tunarr can access the same file paths that Jellyfin uses — no configuration inside Tunarr is needed.In a Docker deployment, add the same bind mounts to your Tunarr container that your Jellyfin container uses. For example, if Jellyfin mounts /media/tv into the container, add the same mount to Tunarr so it can resolve media at those paths.
If Tunarr and Jellyfin are on different machines or use different mount points, configure path replacement rules to transform Jellyfin-reported paths into paths Tunarr can access.Open the Edit dialog for the Jellyfin source
In the Media Sources table, click the Edit button on the row for your Jellyfin server.
Add a path replacement rule
Click Add Path Replacement. Enter the path prefix as Jellyfin reports it and the corresponding path that Tunarr can access locally.
Save the changes
Save the dialog. Tunarr will apply the replacement rule whenever it resolves media file paths from this Jellyfin server.
Path replacements per media source are configurable in alpha versions of Tunarr.
