How to Set Up EPG on Your IPTV Player

The electronic program guide, or EPG, is what turns a bare list of channels into something that actually tells you what's on now and what's coming up next. When it's configured correctly, it just works quietly in the background. When it isn't, you end up with blank rows, wrong air times, or a guide that doesn't match your channel list at all. This guide walks through IPTV EPG setup specifically — how the guide data gets into your player, and how to fix it when it doesn't show up right.

If you're new to the concept itself, our explainer on what EPG is in IPTV covers the basics before you dive into configuration.

Two Ways EPG Data Reaches Your Player

Broadly, your player gets program guide data one of two ways: bundled automatically with an Xtream Codes login, or loaded separately from an external XMLTV URL that you add yourself. Which one applies to you depends on how your subscription is set up, and in some cases you may use both — an Xtream connection for channels with a supplemental XMLTV source for extra coverage.

Setting Up EPG With Xtream Codes

If you logged into your player using an Xtream Codes username, password, and server URL, EPG data typically comes bundled with that connection automatically. There's usually nothing extra to configure — once your channels load, the guide should populate shortly after, often within a few minutes.

If it doesn't, check your player's settings for an EPG source option and confirm it's set to use the provider's built-in guide rather than "none" or a manually entered source, which can sometimes default incorrectly after an app update.

Adding an External XMLTV EPG URL

If you're using an M3U playlist rather than Xtream Codes, or your Xtream guide data is incomplete, most players let you add a separate XMLTV EPG URL. Look for a setting labeled "EPG URL," "XMLTV Source," or "Program Guide" in your player's settings, and paste in the guide URL your provider supplied.

As with M3U links, accuracy matters — copy the URL exactly, including the protocol prefix, and avoid retyping it from memory. For details on entering long playlist-style URLs correctly, see our guide on adding an M3U playlist to your IPTV player, since the same formatting pitfalls apply to EPG URLs.

Fixing Timezone Offset Issues

A guide that loads but shows programs at the wrong time is almost always a timezone problem rather than a broken EPG source. This happens because the EPG data is timestamped according to a specific timezone, and if your device's timezone setting doesn't match, program times will appear shifted by a fixed number of hours.

To fix it:

• Confirm your device's system timezone is set correctly for your actual location, not just the correct time.
• Check whether your player has a separate "EPG time offset" or "GMT offset" setting, distinct from the device clock, and adjust it in hour increments until the guide lines up with what's actually airing.
• If only some channels are off, the issue is likely with that channel's specific guide source rather than a global timezone setting.

Guide Not Populating? Troubleshooting Steps

If the EPG stays completely empty, work through these in order:

• Give it time. Large guide files can take a few minutes to fully load and display, especially on the first sync.
• Re-check the EPG URL. A single typo or an outdated link is the most common cause of a guide that never loads at all.
• Refresh or reload manually. Most players have a manual EPG refresh option in settings — use it rather than waiting indefinitely.
• Restart the app. Closing and reopening the player after adding or changing an EPG source often triggers the initial sync that didn't start automatically.
• Check for a channel name mismatch. Some external XMLTV sources only match channels by exact name, so a channel labeled differently in your playlist than in the EPG file may simply show no data.

For playback issues unrelated to the guide itself — buffering, freezing, or channels not loading — those are covered separately in our broader guide to the best IPTV player settings.

Keeping Your EPG Data Fresh

EPG data changes daily as schedules update, so most players refresh it automatically on an interval, typically every few hours. If you notice the guide falling behind — still showing yesterday's schedule, for instance — a manual refresh from your player's settings usually resolves it immediately. If problems persist across multiple refreshes, it may be worth trying a different player altogether; our comparison of the best IPTV players notes how each one handles EPG reliability.

Frequently Asked Questions