IPTV EPG guide: XMLTV, tvg-id and channel matching
An EPG adds programme names, times and descriptions to an IPTV channel list. The M3U playlist identifies channels; a separate guide feed—often XMLTV—provides the schedule data.
How M3U and EPG data fit together
A playlist entry can include a tvg-id. The EPG feed contains schedule data associated with a corresponding channel identifier. Your player attempts to match the two.
#EXTINF:-1 tvg-id="Example.uk" tvg-name="Example TV" group-title="News",Example TV
https://example.org/live/example.m3u8What is XMLTV?
XMLTV is a widely used XML format for television listings. An XMLTV feed may contain channel IDs, programme start and stop times, titles, descriptions and categories.
Why an IPTV guide shows no programme data
- the M3U
tvg-iddoes not match the XMLTV channel ID; - the EPG URL is offline or blocked;
- the guide feed has not been refreshed;
- the player cached an old mapping;
- time zone settings are wrong;
- the channel simply has no guide data in that source.
EPG time zones
Programme feeds may use UTC offsets or time zone information. If every programme is consistently one hour early or late, check both the player time zone and any EPG offset setting—especially around British Summer Time changes.
Do you need an EPG?
No. An M3U playlist can work without guide data. EPG is an enhancement that makes a channel list easier to navigate, particularly on televisions.