IPTV EPG Setup 2026: Working TV Guide for Any Player

Last updated: June 15, 2026 (Originally published: June 24, 2026)

An IPTV subscription without a working TV guide is half a service. You can watch a channel, but you can’t browse what’s on, scroll forward, set reminders, or rewind to catch the start of a show. This complete IPTV EPG setup guide for 2026 walks through how the EPG (Electronic Program Guide) actually works behind the scenes, how to wire it correctly in every major player, and how to fix the four EPG failures that catch almost every new IPTV user.

The reason this gets confusing is that an EPG comes from a separate file (usually XMLTV format) which your player has to fetch and match against your channels. Knowing what’s actually happening makes the fixes obvious.

What an IPTV EPG actually is

EPG = Electronic Program Guide. It’s the on-screen schedule that shows “now / next” and forward-looking programming per channel. Behind the scenes, it’s a single big XML file (XMLTV format) hosted by your provider, listing every program on every channel for the next 5–7 days.

Your player downloads that XMLTV file, parses it, and matches each entry against your channel list by a unique identifier (tvg-id) that appears in both the M3U file and the EPG file. When the IDs match, the program data appears next to the channel.

If your IPTV EPG setup isn’t working, it’s almost always one of three issues: the XMLTV URL isn’t loaded, the tvg-ids don’t match, or the file is outdated. We’ll cover all three.

Where to find your XMLTV EPG URL

Most quality IPTV providers send it in the activation email next to the M3U URL. Common patterns:

• http://server:port/xmltv.php?username=X&password=Y
• http://server:port/epg/xmltv.gz
• http://server:port/epg.xml

If you got your subscription through the OttOcean free trial or paid subscription, the URL is in the activation email. If you can’t find it, contact your provider’s support — quality providers reply with the URL within hours.

IPTV EPG setup — player by player

TiviMate (Android TV / Google TV / Fire TV)

1. Open Settings → EPG → EPG sources.
2. Add new → paste the XMLTV URL.
3. Set update frequency to Every 6 hours.
4. Save. EPG loads in ~30 seconds.

IPTV Smarters Pro (Android / Fire TV / iOS / Desktop)

1. From the user/profile screen, tap Add EPG URL.
2. Paste the XMLTV URL.
3. Save. Reopen the live TV section — EPG appears.

SS IPTV (LG webOS)

1. Settings → EPG → External EPG URL.
2. Paste the XMLTV URL.
3. Save. Restart the app.

SIPTV (Samsung / LG)

1. Settings → EPG → External EPG URL.
2. Paste the XMLTV URL.
3. Save. Restart SIPTV.

GSE Smart IPTV (iOS)

1. EPG → Add EPG → URL → paste.
2. Save. Refresh.

Kodi (PVR IPTV Simple Client)

1. Settings → Add-ons → PVR Clients → PVR IPTV Simple Client → Configure.
2. Open EPG settings → Remote XMLTV URL → paste.
3. OK. Restart Kodi.

The XMLTV format in plain English

If you’ve ever opened the XML file, it looks something like:

<tv>
  <channel id="cnn.us">
    <display-name>CNN</display-name>
  </channel>
  <programme channel="cnn.us" start="20260615120000 +0000" stop="20260615130000 +0000">
    <title>CNN Newsroom</title>
    <desc>Top stories from around the world.</desc>
  </programme>
</tv>

Each channel id must match a tvg-id in your M3U for the program data to attach. That’s the entire matching logic.

The four EPG failures that catch everyone

Failure 1 — EPG URL never loaded

You loaded the M3U or Xtream Codes credentials, opened the guide button, and saw nothing. Your player has no EPG source configured. Go back to the player-specific steps above.

Failure 2 — EPG URL loaded but no data shows

The tvg-ids in your M3U don’t match the channel ids in the XMLTV. Two ways to fix:

• Switch to Xtream Codes (most providers auto-align tvg-ids).
• Manually map channels in TiviMate: Settings → EPG → Channel mapping. Tedious for a 5,000-channel lineup, but you only need to do it for the channels you actually watch.

Failure 3 — EPG was working, now is stale

The XMLTV file hasn’t been refreshed. In every player, set the update frequency to 6–12 hours. TiviMate Premium can refresh on app launch.

Failure 4 — Wrong timezone

EPG shows shows offset by 5+ hours. The XMLTV file has timestamps in UTC; your player needs to know your timezone to display them correctly. In TiviMate: Settings → EPG → Timeshift, set to your local UTC offset.

Bonus: how IPTV EPG setup unlocks catch-up TV

Catch-up TV (the ability to “rewind” a channel to an earlier program) relies on your IPTV EPG setup being correct, because the player needs to know what aired when. If EPG is broken, catch-up usually doesn’t work either.

Once EPG is healthy, in TiviMate Premium: long-press a past show in the guide → Play. The provider serves the cached stream. Realistic catch-up window: 24–72 hours depending on the channel and provider.

How to validate IPTV EPG setup in 60 seconds

The smoke test:

1. Open your IPTV player.
2. Press the guide button.
3. For the top 10 channels you actually watch, confirm “now” data is populated.
4. Scroll forward two hours. Confirm program titles for the upcoming slot.
5. Scroll forward two days. The guide should populate (with slightly less detail).

If any of those fail, return to the failure modes above.

EPG providers separate from your IPTV provider

If your IPTV provider’s EPG is incomplete or stale (some are), there are public XMLTV EPG providers you can use instead — they harvest EPG data from broadcaster sources directly. Examples:

• EPG.best — paid, comprehensive, country-specific.
• i.mjh.nz — free, good for US / UK / AU.
• iptvx.one — community-maintained.

You can load multiple EPG URLs in TiviMate — Settings → EPG → EPG sources → add several. The player merges them. Useful if no single source has all your channels.

The bottom line

A clean IPTV EPG setup is the difference between a flat channel list and a real TV-guide experience. Get the XMLTV URL from your provider, paste it into your player’s EPG settings, set update frequency to 6–12 hours, and confirm tvg-id matching. Three minutes of work. To verify against a quality provider, the OttOcean free trial ships both the M3U and the XMLTV URL in the activation email — perfect for a hands-on test. For the underlying format reference, see the XMLTV reference. For more on player choice, our best IPTV player apps roundup covers which apps handle EPG best.

FAQ: IPTV EPG setup

What is IPTV EPG setup?

Loading your provider’s XMLTV file URL into your player so the on-screen TV guide shows “now / next” and forward-looking schedules.

Why does my IPTV EPG show no data?

Either the XMLTV URL isn’t loaded, the tvg-ids don’t match between M3U and XMLTV, or the file is stale. Cover all three with the steps above.

Can I have IPTV EPG without paying anything extra?

Yes. Most quality providers include the XMLTV URL with the subscription. Free public EPG sources also work for major broadcasters.

How often does the IPTV EPG refresh?

Set your player to refresh every 6–12 hours. The provider’s XMLTV file itself regenerates every few hours.

Does IPTV EPG setup work on every player?

Every major player supports XMLTV EPG: TiviMate, Smarters Pro, SS IPTV, SIPTV, NetIPTV, GSE, IBO Player, Kodi, VLC (partially). The exact menu name varies but the concept is identical.