Tunarr TV Guide

Create your own live TV channels from media on Plex, Jellyfin, Emby, or local files.

GitHub Release Docker Pulls GitHub Stars Discord License

Tunarr lets you build custom live TV channels out of your existing media libraries — movies, TV episodes, music videos, or local files — and stream them as if they were real broadcast channels.

Tune in by adding Tunarr's spoofed HDHomeRun tuner to Plex, Jellyfin, or Emby, or grab the M3U URL for any IPTV player like Tivimate or UHF.

Media Sources

• Connect Plex, Jellyfin, Emby, or local file libraries
• Advanced search, filter, and sort across all connected libraries

Channel Management

• Drag-and-drop lineup editor
• Filler content between programs (commercials, music videos, prerolls, branding)
• Per-channel logos and automatic configuration backups

Scheduling

• Time-slot and random-slot scheduling tools
• Web-based TV guide for viewing channel lineups

Playback & Integration

• Spoofed HDHR tuner for Plex, Jellyfin, and Emby
• M3U/IPTV output for Dispatcharr, Threadfin, xTeVe, or any IPTV client
• Stream channels directly in the browser
• Per-channel audio language and subtitle preferences

Transcoding

• Hardware-accelerated transcoding: Nvidia NVENC, VAAPI, Intel QuickSync, macOS VideoToolbox
• Multiple transcode profiles, configurable per channel

The easiest way to run Tunarr is with Docker Compose. Create a docker-compose.yml:

services:
 tunarr:
 image: chrisbenincasa/tunarr:latest
 container_name: tunarr
 ports:
 - 8000:8000
 environment:
 - TZ=America/New_York
 volumes:
 - ./tunarr-data:/config/tunarr
 restart: unless-stopped

Then run:

docker compose up -d

Tunarr will be available at http://localhost:8000.

Other installation options:

For hardware-accelerated transcoding setup, see the transcoding docs.

• Installation guide
• Creating channels
• Scheduling tools
• Transcoding configuration
• Full documentation

pnpm i
pnpm turbo dev # backend at :8000, frontend at :5173/web

See CONTRIBUTING.md for a full development guide.

• Discord — chat, help, and announcements
• GitHub Issues — bug reports and feature requests
• GitHub Discussions — questions and general conversation

Tunarr is released under the Zlib License.