What Is an EPG in IPTV? XMLTV, Channel IDs, and Programme Data

What does EPG mean?

EPG stands for Electronic Programme Guide. It is structured information about programmes, such as titles, descriptions, start times, end times, episode information, and channel identifiers.

An EPG is therefore different from the media stream. A player can have a working stream with no guide data, or guide data for a channel whose stream is currently unavailable.

How an EPG works

A player retrieves programme-guide data from a source and associates that data with channels in its playlist or service account. The application then uses the matching records to display schedules such as what is on now and what comes next.

Different services and players use different data formats and matching rules. Follow the documentation for the source and player rather than assuming every EPG feed is interchangeable.

EPG vs. M3U playlist

An M3U playlist and an EPG solve different parts of the same interface. The playlist describes media entries or locations. The EPG describes programming associated with channels.

• M3U: channel or media entry information and locations.
• EPG: programme names, descriptions, schedules, and related metadata.
• Player: combines supported data to create the channel and programme interface.

What is XMLTV?

XMLTV is a commonly used XML-based format for television programme data. An XMLTV document can contain channels and programme records that applications use to build an EPG.

The presence of XMLTV does not guarantee that a particular player will import the feed correctly. The player may require a specific URL, identifier convention, timezone handling, or configuration.

How channels are matched to programme data

Matching usually depends on an identifier shared between the channel entry and the EPG data. If the identifiers do not match, a player may show a channel with no programmes even though the EPG source contains schedule information.

Channel names alone may not be a reliable matching key because names can vary in spelling, language, punctuation, or regional form.

• Check the channel identifier used by the playlist or service.
• Check the corresponding identifier in the EPG source.
• Look for duplicate or regional channel entries.
• Follow the player's documented EPG mapping options when manual mapping is supported.

Time zones and programme schedules

Guide data can appear shifted when the source, device, or player interprets times in different time zones. Daylight-saving rules can also affect how schedules are displayed.

When programme times look wrong, check the source timezone, device timezone, player settings, and any documented XMLTV timezone information before changing channel mappings.

Why EPG data can be missing or incorrect

A missing guide can come from a failed EPG request, an expired or unavailable source, an identifier mismatch, incomplete schedule coverage, timezone handling, or player compatibility. It is useful to separate these cases instead of treating every blank guide as a stream problem.

• The EPG source cannot be reached.
• The guide does not contain the channel identifier your player expects.
• The programme schedule is incomplete or outdated.
• The player cannot parse or import the supplied format.
• Timezone or daylight-saving settings shift the displayed times.

A practical EPG diagnostic

Start with one channel that you know should have programme data. Confirm that its stream or playlist entry works, inspect the channel identifier if the player exposes it, then check whether the EPG source contains the same identifier and current programme records. This narrows the problem before you change player settings.