Tunarr finds media to use in channels from one or more media sources. A media source is any system — a Plex server, a Jellyfin server, an Emby server, or a local filesystem directory — that Tunarr can scan to discover content. You must have at least one media source configured before you can add programming to a channel. Once connected, you can browse and schedule content from all of your sources in one place.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.
What Media Sources Provide
When you add a media source, Tunarr scans its libraries and indexes the available content. This gives you several capabilities across all source types:- Browse and search media when building channel schedules and playlists
- Automatic metadata detection for titles, episode numbers, artwork, and more
- Multiple simultaneous sources — you can add more than one server of the same type and freely mix content across them
You can add multiple media sources of the same type. For example, you could connect two different Plex servers and use content from both in the same channel.
Supported Source Types
Plex
Connect your Plex Media Server using automatic OAuth discovery or a manual token. Access movies, TV shows, and other media from your Plex libraries.
Jellyfin
Connect your Jellyfin server using a URL and API key (or username and password). Use any of your Jellyfin libraries as a content source.
Emby
Connect your Emby server using a URL and API key. Access your Emby media libraries for scheduling in Tunarr channels.
Local Files
Use media files directly from your filesystem without a media server. Supports movies, TV shows, music, music videos, and other video content.
Library Synchronization
For external servers (Plex, Jellyfin, and Emby), Tunarr supports library sync — a scheduled, one-way import of metadata from your media server into Tunarr’s own database. Syncing is strictly read-only: Tunarr will never modify or delete data on your media server. Synced metadata powers richer search and scheduling experiences inside Tunarr. Libraries are synchronized on a configurable interval (defaulting to every 6 hours). You can enable or disable individual libraries per source from the Media Sources settings page.Library synchronization is an alpha-only feature planned for general availability in v1.0.
Streaming from Disk
For all external media sources, Tunarr recommends having direct access to the underlying media files on disk. Streaming directly from disk — rather than proxying through your media server over the network — improves performance, reduces transcoding overhead, and makes streaming more stable. There are two approaches to achieve this:- Share the same paths — Ensure Tunarr can access the same file paths that your media server sees. In Docker environments, this typically means adding the same bind mounts to your Tunarr container.
- Configure path replacements — If your Tunarr instance sees different paths than your media server, you can configure per-source path replacement rules that transform the server-reported paths into ones accessible to Tunarr.