When you launch Tunarr for the first time, the web UI walks you through a short setup wizard before you can start creating channels. The wizard has three steps: connecting a media source, verifying the FFmpeg path, and finishing setup to land on the channel creation page. By default, Tunarr is available atDocumentation 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.
http://localhost:8000.
Connect a Media Source
The first screen prompts you to connect at least one media source. Tunarr currently supports:
- Plex — Connect one or more Plex Media Servers using your Plex account or a direct server URL and token.
- Jellyfin — Connect using your Jellyfin server URL and an API key generated in the Jellyfin dashboard.
- Emby — Connect using your Emby server URL and an API key from the Emby admin panel.
- Local files — Point Tunarr at a directory of video files on the host without needing a media server.
You can add, remove, and reconfigure media sources at any time after initial setup from the Media Sources section in the settings. See the Media Sources page for full configuration details.
Configure FFmpeg
Tunarr uses FFmpeg to normalize video and audio streams for seamless playback between programs, interleave filler content, and handle transcoding. The setup wizard will show the detected FFmpeg path and its version status.If you are running the standalone binary, Tunarr defaults to looking for FFmpeg at
The recommended build is the ErsatzTV FFmpeg 7.1.1 release — this is the same build that ships in Tunarr’s Docker images. Builds from BtbN/FFmpeg-Builds or gyan.dev also work in most cases.
Docker images ship with FFmpeg 7.1.1 pre-installed at
/usr/bin/ffmpeg. If you are running Tunarr in Docker, the path is already configured correctly and you do not need to make any changes on this screen./usr/bin/ffmpeg. If no executable is found at that path, enter the full path to your FFmpeg binary in the settings field.FFmpeg version requirements:| Status | Version |
|---|---|
| Minimum supported | 6.1 |
| Recommended | 7.1.1 |
Finish Setup and Create Your First Channel
Once a media source is connected and FFmpeg is configured, click Finish to complete the wizard. Tunarr will take you directly to the new channel page where you can name your channel, set a logo, and start building a lineup.From the channel page you can drag media from your connected libraries into the lineup, set up filler content, and configure scheduling. See Channel Properties for a full walkthrough of channel configuration options.