AdvertisementLeaderboard / responsive slot
Electronic programme guide

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.m3u8

What 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.

AdvertisementResponsive in-content slot

Why an IPTV guide shows no programme data

  • the M3U tvg-id does 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.

M3U.co.uk toolkit

Learn the format. Inspect the playlist. Fix the problem.

Explore free tools