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.
Once your channels are built and populated with programming, you’re ready to watch them. Tunarr exposes your channels through two connection methods: HDHomeRun emulation, which lets media servers like Plex, Jellyfin, and Emby auto-discover Tunarr as a network tuner, and M3U + XMLTV endpoints, which work with any IPTV player or playlist manager. Both methods deliver full guide data (EPG) alongside the live stream.
Connection Methods
HDHomeRun Emulation
Tunarr impersonates an HDHomeRun network tuner on your local network. Media servers that support HDHomeRun devices — Plex, Jellyfin, and Emby — can scan for and discover Tunarr automatically, just as they would detect a physical tuner. This provides the most seamless integration: guide data is mapped automatically, and channels appear natively in your media server’s Live TV section.
If auto-discovery does not find your Tunarr instance, you can always enter the address manually: http://<tunarr-host>:8000
M3U Playlists and XMLTV Guide
For IPTV apps and any player that supports M3U playlists, Tunarr generates standard endpoints:
| Endpoint | URL |
|---|
| All channels (M3U) | http://<tunarr-host>:8000/api/channels/m3u |
| EPG guide (XMLTV) | http://<tunarr-host>:8000/api/xmltv.xml |
<tunarr-host> with your server’s IP address or hostname and the port Tunarr is running on (default 8000).
Setting Up Your Client
Plex
Jellyfin
Generic IPTV
Plex integrates with Tunarr through its Live TV & DVR feature. Tunarr acts as an HDHomeRun tuner and provides guide data through XMLTV.Open Plex DVR settings
In Plex, navigate to Settings → Manage → Live TV & DVR, then click Set Up Plex Tuner.
Confirm or enter the Tunarr address
Plex will scan for HDHomeRun devices on your network. If Tunarr appears automatically, select it. If it does not, click Don’t see your HDHomeRun device? Enter its network address manually and enter:http://<tunarr-host>:8000
Add the XMLTV guide
After selecting the tuner, click Have an XMLTV guide on your server? Click here to use it. In the XMLTV Guide field, enter:http://<tunarr-host>:8000/api/xmltv.xml
Map channels and finish
Click Continue. Plex will automatically map your Tunarr channels. Review the mapping and click Continue again to complete setup.
Watch your channels
Your Tunarr channels now appear under the Live TV section in Plex. Select View Guide to open the EPG, then hover over any channel tile and click the play icon to start watching.
The Plex Windows desktop client is not currently supported for Live TV and will show a “This Live TV session has ended” error. Windows users should use the Plex Web client at http://<plex-host>:32400/web until this is resolved. See issue #718 for tracking. Jellyfin connects to Tunarr as either an HDHomeRun tuner or an M3U source. The HDHomeRun method is recommended — some users have experienced stream stability issues at program boundaries when using the M3U tuner type in Jellyfin without transcoding enabled.Open the Jellyfin Admin Dashboard
On the Jellyfin homepage, open the hamburger menu and select Dashboard under the Administration section.
Navigate to Live TV
In the Dashboard sidebar, locate and click Live TV under the Live TV section.
Add an HD HomeRun tuner
Click Add Tuner Device and select HD HomeRun as the tuner type. Click Detect My Devices to let Jellyfin scan for Tunarr automatically. If it is not found, enter the address manually:http://<tunarr-host>:8000
Add the XMLTV guide provider
Click Add next to Guide Providers and choose XMLTV. In the File or URL field, enter:http://<tunarr-host>:8000/api/xmltv.xml
Save and verify
Click Save. Jellyfin will return to the Live TV screen and begin updating guide data. Once complete, navigate back to the Jellyfin home page — a Live TV card should appear in your media section. Open it to see your channels under the Programs, Channels, or Guide tabs.
Some users have experienced stability issues at program boundaries when using Tunarr as an M3U tuner in Jellyfin, particularly when Jellyfin is not transcoding or remuxing the stream. Using the HD HomeRun connection method avoids this. See jellyfin/jellyfin-ffmpeg#57 for context. Any IPTV player that accepts an M3U playlist URL and an XMLTV EPG URL can be pointed directly at Tunarr. Use the following endpoints, substituting your server’s IP address and port:| What | URL |
|---|
| M3U playlist | http://<tunarr-host>:8000/api/channels/m3u |
| XMLTV EPG | http://<tunarr-host>:8000/api/xmltv.xml |
Recommended Apps
| Platform | App |
|---|
| iOS / Apple TV | UHF |
| Android TV | TiviMate |
| Cross-platform | VLC |
