IPTV EPG Setup Complete Guide (2026): Fix Guide Data Fast

An Electronic Programme Guide (EPG) is the difference between “it plays channels” and a TV-like experience where you can browse what’s on now, what’s next, and schedule your viewing. When it works, it feels effortless. When it doesn’t, you get empty grids, wrong times, mismatched programmes, or a guide that never updates.

This complete guide walks you through a reliable, repeatable EPG setup using XMLTV, plus the most common fixes for Ibo Player, MAT Player, and Duplex TV.

TL;DR: The fastest way to fix an IPTV EPG

If your guide is blank or wrong, do these in order:

Confirm your provider actually includes EPG data (many “cheap” lines do not).
Find the correct XMLTV EPG URL in your provider dashboard (or ask support).
Add the EPG URL in your IPTV app, then force an EPG refresh.
Set your time zone / time offset correctly (DST mistakes are very common).
If channels show the wrong programme, enable (or redo) EPG channel matching.

If you want the long-term “set-and-forget” result, keep reading.

What an IPTV EPG is (and why it fails)

Most IPTV services deliver EPG data as XMLTV (an XML file). Your IPTV app downloads that file, maps channels to EPG entries, then renders a guide grid.

An EPG usually fails for one of these reasons:

No EPG source: Your subscription does not include EPG, or the provider URL is missing/invalid.
Blocked or slow EPG endpoint: The EPG server is overloaded, rate-limited, or geo-blocked.
Wrong time zone / DST shift: Guide times are offset by 1–2 hours (or more).
Bad channel mapping: Programme data exists, but it is attached to the wrong channels.
Caching issues: The app cached an old EPG file and won’t refresh properly.

Fixing EPG is mostly about validating the source, then making mapping deterministic.

Step 1: Get the correct EPG URL from your IPTV provider

Your provider will usually expose one (or more) EPG URLs:

XMLTV URL (most common; ideal for EPG grids)
A provider-specific EPG token URL (sometimes expires and must be regenerated)

What to look for:

A URL that contains xml, xmltv, or epg somewhere in the path.
A token or key parameter (do not share it publicly).

If you can’t find the URL, ask support for “the XMLTV EPG link for my line”.

Step 2: Add the EPG URL in your app (Ibo Player, MAT Player, Duplex TV)

Exact menu labels differ by version, but the setup concept is the same:

Open your app settings.
Find the EPG section (often named EPG, Guide, or Programme Guide).
Paste the provider’s XMLTV URL.
Save, then trigger an immediate update.

Ibo Player: EPG setup pointers

If you have multiple playlists, confirm you are editing the EPG for the correct playlist.
After saving the EPG URL, run a manual update once, then set a schedule (daily is enough).

MAT Player: EPG setup pointers

MAT Player can cache aggressively; after adding a new EPG URL, do a full refresh.
If your guide is consistently one hour off, check the time offset and DST settings first.

Duplex TV: EPG setup pointers

Duplex TV is sensitive to channel mapping; if the guide exists but is wrong, redo matching.
If you use multiple sources, try a single EPG URL first to validate your baseline.

Step 3: Set the correct time zone and EPG offset

Wrong times are usually not “bad EPG data”, but a time conversion issue.

Check these settings:

Device time zone: Make sure your TV/box/phone is set correctly.
App EPG time shift / offset: Some apps offer “+/- hours” for guide time alignment.
DST toggle: If your region uses daylight saving time changes, confirm the app handles it.

How to verify quickly:

Open the guide for a channel you know (news channels are good for this).
Compare what’s on now with the guide “now” slot.
If it’s consistently off by exactly 1 or 2 hours, adjust the EPG offset and re-check.

Step 4: Fix channel mapping so programmes match the right channels

When the EPG has data but it’s attached to the wrong channel, you get a guide that looks “full” but incorrect.

Common mapping causes:

Provider channel names include extra suffixes (e.g., “HD”, “UK”, “Backup”).
The app imports duplicate channels, and the EPG binds to the wrong copy.
The app tries to auto-match by name and chooses the closest match (often wrong).

Best practices:

Prefer provider-supplied channel IDs when your app supports it.
If your app supports “manual match”, match a handful of key channels first, then refresh.
Remove duplicates before matching (a smaller channel list maps more reliably).

Step 5: Choose a good EPG update schedule (and avoid peak hours)

EPG files can be large. Updating at the wrong time can slow the app, stall loading, or fail silently.

Recommended schedule:

Once per day (usually enough for a 24–72 hour guide window)
Run updates during off-peak hours (early morning is ideal)

If your EPG frequently goes stale:

Switch from “auto update” to a defined schedule.
If you travel between networks, trigger a manual update after switching Wi‑Fi networks.

Step 6: Troubleshooting checklist (common EPG problems)

The EPG is completely blank

Try this sequence:

Re-check the EPG URL (copy/paste again to avoid whitespace).
Force an EPG refresh in the app.
Restart the app (some versions only reload EPG on launch).
If nothing changes, your provider may have EPG disabled on your line.

The EPG times are wrong (everything shifted)

This is almost always time zone or DST:

Verify the device time zone.
Adjust the app EPG time shift in 1-hour increments.
Refresh the EPG after changing the offset.

The EPG shows the wrong programmes for a channel

This is mapping:

Clear duplicates in your channel list.
Redo auto-match, or manually match key channels.
Refresh the EPG after matching.

The EPG updates, but only some channels have data

This can be normal:

Some providers only ship EPG for major networks, not every niche channel.
Some channels are mis-labeled in the playlist and won’t match any EPG entry.

If it’s important, ask support whether they provide a “full EPG” feed, or an alternate EPG URL.