Tunarr lets you build custom live TV channels from your existing media libraries — movies, TV episodes, music videos, or local files — and stream them as if they were real broadcast channels. Instead of browsing on-demand catalogs, Tunarr gives you and your household a scheduled, linear TV experience built entirely from content you already own.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.
How Tunarr Works
Tunarr sits between your media servers and your playback clients. You connect one or more media sources (Plex, Jellyfin, Emby, or local files), build channel lineups from your libraries, and Tunarr handles transcoding, scheduling, and stream delivery. Clients tune in just like they would to a real cable or over-the-air channel — no on-demand browsing required.Client Connections
Tunarr exposes two standard interfaces so virtually any media client can tune in without special configuration:- HDHomeRun emulation — Tunarr presents itself as a Silicon Dust HDHomeRun network tuner. Plex, Jellyfin, and Emby all natively discover and add HDHomeRun devices, so your channels appear automatically in their Live TV sections.
- M3U / IPTV playlist — Every Tunarr instance publishes an M3U URL. Import it into any IPTV client such as Tivimate, UHF, Dispatcharr, Threadfin, or xTeVe.
- Browser streaming — Channels can also be watched directly in the Tunarr web UI without any additional client.
Supported Media Sources
| Source | Notes |
|---|---|
| Plex | Connect one or more Plex servers; search and filter across all libraries |
| Jellyfin | Full library integration including metadata and artwork |
| Emby | Full library integration including metadata and artwork |
| Local files | Add folders of video files directly without a media server |
Key Features
Channel Management — A drag-and-drop lineup editor lets you arrange movies, episodes, and filler content (commercials, music videos, pre-rolls, branding) on each channel. Channels get their own logos and are backed up automatically. Scheduling — Time-slot and random-slot scheduling tools fill your channels with content on a recurring basis. A web-based TV guide shows exactly what is airing and when. Transcoding — FFmpeg-based transcoding normalizes video and audio for seamless playback across programs. Hardware acceleration is supported for Nvidia NVENC, VAAPI, Intel QuickSync, and macOS VideoToolbox. Playback preferences — Set per-channel audio language and subtitle preferences so every stream sounds the way you want.Get Started
Installation
Install Tunarr via Docker, standalone binary, or the Proxmox LXC helper script.
Channels
Create your first channel and start building a lineup from your media library.
Scheduling
Use time-slot and random-slot tools to keep your channels filled automatically.
API Reference
Explore the Tunarr REST API to automate channel management and integrations.