Install your player · WhatsApp us for a one-day free trial

The 8K IPTV journal

Add an XMLTV guide to a compatible IPTV player

An XMLTV guide contains programme metadata such as channel identifiers, titles and scheduled times. It does not replace the video playlist. In a compatible player, add the guide through the EPG settings and then match its channel identifiers to the channels already loaded.

Illustrated guide: Add an XMLTV guide to a compatible IPTV player
How is an XMLTV EPG different from a channel playlist?

An XMLTV guide contains programme metadata such as channel identifiers, titles and scheduled times. It does not replace the video playlist. In a compatible player, add the guide through the EPG settings and then match its channel identifiers to the channels already loaded.

Use the guide field, not the video field

A playlist URL belongs in a playlist import control; an XMLTV URL belongs in the guide configuration. Pasting a guide into a media playback box may simply produce an unsupported-file error. Read the app’s labels because the location of EPG settings varies.

Allow the first guide import time

A guide covering many channels can be larger than expected. Leave the player open while it downloads and processes the data. If there is a last-updated timestamp, record it so you can distinguish old cached listings from a new import.

Verify a small sample

Compare the current and next programmes on two or three channels whose region you recognise. If all times are displaced equally, investigate time settings. If only one channel is wrong, investigate its mapping rather than changing the global offset for every channel.

Questions about this topic

Does XMLTV include recorded programmes?
No. It describes schedules. Catch-up or recordings require separate content and player support.
Can one guide cover several playlists?
A player may support that arrangement, but identifiers still need to match and the app must support the configuration.

Sources & further reading

Keep reading

Related guides.

Illustrated guide: Channel numbers and custom ordering in a player

Channel numbers and custom ordering in a player

Channel numbers may be generated from playlist order or assigned locally by the player. When the source list changes, those positions can move. If consistent daily navigation matters, use supported favourites and local ordering rather than relying on a source position that may change.

Explore guide ↗

Your next screen starts here

Installed your player?

WhatsApp us for a one-day free trial. Tell us your device and the player you installed so we can help you get connected.

WhatsApp support