Skip to main content

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 Emby servers. All metadata — titles, artwork, episode details, and more — is read directly from Emby. Once connected, you can browse your Emby libraries when building channel schedules and combine Emby content with other media sources.

​
Connecting an Emby Server

To add an Emby server, navigate to Settings > Sources in the Tunarr web UI, click Add, and choose Emby. You will be presented with a dialog to enter the connection details. The process is very similar to connecting a Jellyfin server — Emby and Jellyfin share a common API lineage, so the steps are nearly identical.
1

Open Media Sources settings

In the Tunarr web UI, navigate to Settings > Sources.
2

Click Add and select Emby

Click the Add button in the Media Sources toolbar, then select Emby from the dropdown.
3

Enter the server URL

In the Add Emby Media Source dialog, enter the full URL of your Emby server, including the port if applicable (for example, http://192.168.1.100:8096).
4

Enter the API key

Generate a dedicated API key for Tunarr in the Emby admin dashboard:
  1. In Emby, go to Admin Dashboard > API Keys.
  2. Click New API Key and give it a recognizable name such as “Tunarr”.
  3. Copy the generated key and paste it into the API Key field in the Tunarr connection dialog.
Using a dedicated API key makes it easy to revoke Tunarr’s access independently of your Emby account credentials.
5

Save and confirm

Click Save. If the server URL is reachable and the API key is valid, your Emby server will appear in the Media Sources table.

​
Library Synchronization

After connecting your Emby server, you can configure Tunarr to periodically import metadata from your Emby libraries. Synchronization is strictly one-way — Tunarr reads from Emby and never modifies or deletes data on your Emby server.
Library synchronization is an alpha-only feature planned for general availability in v1.0. Enabling sync provides richer search and scheduling capabilities inside Tunarr.
1

Open the Edit Libraries dialog

In the Media Sources table, find your Emby server and click the Edit Libraries button.
2

Select libraries to sync

You will see a list of all Emby libraries that Tunarr can access. Toggle on any libraries you want Tunarr to synchronize.
3

Wait for the initial sync

Selected libraries are queued for synchronization immediately. Tunarr processes one library per source at a time and will update the sync status in the Media Sources table.
By default, all enabled libraries are re-synchronized every 6 hours. You can change this interval from the Media Source settings page for your Emby server.

​
Streaming from Disk

For the best streaming performance, Tunarr should have direct access to the media files on disk rather than fetching them through Emby over the network. There are two ways to configure this.

Build docs developers (and LLMs) love

Get started for freeTalk to us