Skip to content

Setup

Initial Setup

The first time you open Tunarr, it shows a Welcome page with a setup checklist. By default, Tunarr is available at http://localhost:8000.

Each step updates once it is done, and each one links to its page in these docs. You don't have to follow the checklist. Click Skip Setup to go straight to the guide, and do everything from the menu instead. Once you skip or finish, Tunarr stops showing the page. Installs upgraded from a version without the checklist never see it.

Welcome checklist

Connect a media source

Tunarr supports Plex, Jellyfin, Emby, and local media as media sources. You must connect at least one media source and enable at least one of its libraries before you can add programming to your channels. Each media source acts as a metadata source for your programming, and optionally, the streaming source.

See the media sources page for more info on configuring media sources!

Scan your libraries

Tunarr scans enabled libraries in the background. This step checks itself off when the first scan finishes. Channels can only use programs that have been scanned by Tunarr.

Check FFmpeg

Info

FFmpeg is included in Tunarr Docker images. When Tunarr runs in a container, this step is hidden unless the FFmpeg check reports a warning or an error.

Tunarr requires FFmpeg. FFmpeg is used to normalize channel video / audio streams for seamless playback, interleave your "flex" content, and more. Tunarr defaults to looking for the FFmpeg executable at /usr/bin/ffmpeg. If no executable is found, or the version is too old, this step shows the problem and links to the FFmpeg settings page, where you can change the path. Only an error blocks Finish. A warning, such as a version string Tunarr cannot parse, shows here but does not block setup. The minimum known supported version of FFmpeg is 6.1. The recommended version is 8.1.2. We recommend this build of FFmpeg as it matches what is shipped in Tunarr docker containers.

Create a channel

Click New Channel to create your first channel.

Watch from a client

This step lists the M3U playlist and XMLTV guide links to add to an IPTV client. Jellyfin and Emby can use Tunarr as either an M3U source or an HDHomeRun tuner. Plex can add Tunarr as an HDHomeRun tuner. See clients for setup steps. This step is optional.

Click Finish once every required step is checked off.

Finished checklist