Tunarr automatically generates an XMLTV-formatted Electronic Program Guide (EPG) for all active channels. This guide data allows media clients — Plex, Jellyfin, Emby, Channels DVR, and others — to display program titles, descriptions, air dates, and other metadata alongside your live streams in their guide views. No manual curation is required; Tunarr builds the EPG continuously from the metadata already attached to your media.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.
The XMLTV Endpoint
Tunarr writes XMLTV data to a file in its data directory, but clients should always consume it through the API endpoint rather than reading the file directly:What Data Tunarr Includes in the EPG
Tunarr populates the XMLTV output with program metadata sourced from your media libraries. The following fields are included when available:| XMLTV Field | Source |
|---|---|
| Program title | Media library title metadata |
| Episode title | Media library episode name |
| Description / plot summary | Library description metadata |
| Air date and year | Library air date metadata |
| Content rating | Library content rating metadata |
| Cast and crew credits | Library cast/crew metadata |
| Genres | Library genre tags (written as XMLTV <category> elements) |
Genre data is only included for programs that have genre metadata in the originating media source. If a program’s entry in your media server has no genres attached, the
<category> tag will not be present for that program in the XMLTV output. Clients that display genre information in their guide — such as Channels DVR — will pick up these categories automatically when they are present.Connecting a Client to the EPG
The general pattern for connecting any IPTV-capable client to Tunarr is the same: provide the M3U URL for channel discovery and the XMLTV URL for guide data. The exact settings location differs by client:- Plex — Add an IPTV source under Live TV & DVR settings.
- Jellyfin — Add a Live TV tuner device with the M3U URL, then add a guide data provider with the XMLTV URL.
- Channels DVR — Add Tunarr as an M3U source, then point the guide data source at the XMLTV URL.
- Emby — Similar to Jellyfin; add the M3U tuner and XMLTV guide source separately.