EPG¶
Tunarr generates an XMLTV-formatted Electronic Program Guide (EPG) for all active channels. This guide data can be consumed by media clients (Plex, Jellyfin, Emby, Channels DVR, etc.) to display program schedules and metadata alongside the live stream.
XMLTV Output¶
Tunarr writes XMLTV data to an .xml file in the data directory, but clients should always consume it via the API endpoint rather than reading the file directly:
The full URL is also available in the Tunarr web UI under Settings > HDHR / M3U. Point your client's guide data source at this URL to populate the program guide.
To write the file somewhere else, stop Tunarr and set xmltv.outputPath in settings.json in the data directory. The directory must already exist, because Tunarr does not create it. If Tunarr cannot write to that location, it logs a warning and uses the default path until the location becomes writable, such as when a network share mounts. Your setting is kept.
Program Metadata¶
Tunarr populates the XMLTV output with program metadata sourced from your media libraries, including:
- Program title and episode title
- Description / plot summary
- Air date and year
- Content rating
- Cast and crew credits
- Genres — included under the XMLTV
<category>tag, sourced from the genre metadata attached to each program in your media library. Clients that display genre information in their guide (e.g., Channels DVR) will pick these up automatically.
Info
Genre data is only available 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.