IPTV EPG Guide: Setup, XMLTV, and Troubleshooting

What an EPG does in an IPTV player

EPG stands for electronic program guide. It supplies programme titles, start and end times, descriptions, and other schedule information that a compatible player displays beside live channels. The video stream and the guide are separate: a channel can play correctly while its schedule remains blank.

Most IPTV setups combine an M3U playlist with an XMLTV guide source. The playlist identifies the available channels, while XMLTV describes the schedule. A player uses channel identifiers and, in some cases, channel names to decide which guide record belongs to which playlist entry.

Choose the right EPG task

Start with the symptom rather than changing several settings at once. If this is a new installation, follow the setup guide. If the guide used to work, test the source URL and refresh the stored data. If programmes appear against the wrong channels, focus on channel mapping instead of repeatedly reloading the source.

• New setup: add the guide URL, assign it to the playlist, and run the first update.
• Blank guide: verify the source, refresh it, then inspect channel matches.
• Wrong programme times: check the device clock before applying an EPG offset.
• Only some channels are missing: compare playlist channel IDs with the XMLTV channel IDs.

How XMLTV, EPG URLs, and channel IDs fit together

XMLTV is a common text format for exchanging TV listings. An EPG URL normally points to an XML or compressed XMLTV document that the player downloads on a schedule. Inside that document, each channel has an identifier and each programme references one of those identifiers.

The playlist may expose the corresponding value through a tvg-id attribute. When that value matches the XMLTV channel ID, guide assignment is usually reliable. Names and logos help people recognize channels, but a stable identifier is the safer basis for automatic mapping.

A reliable troubleshooting order

Confirm the device date, time, and time zone first. Next, test whether the EPG URL is reachable and still returns guide data. Then make sure the correct source is assigned to the correct playlist. Refresh the guide only after those checks; clearing data too early can hide the original cause.

Finish by checking one known channel. Look for a matching playlist ID, XMLTV channel record, and current programme entry. A single controlled example tells you more than changing global settings repeatedly.

Device and player differences

Players use different labels for the same actions. One app may call the setting EPG sources, another TV guide, and another programme guide. Refresh controls may sit under playlist settings, data sources, or a general update menu.

The exact menu can change between app versions, but the underlying sequence is consistent: add a valid source, associate it with the playlist, update the data, map any unmatched channels, and confirm the time settings.