Skip to content
Free 24-hour test — no card needed. Claim it on WhatsApp →
4K IPTV Subs

Guides

How to Add an EPG URL to Your IPTV Player

Published 2 min readBy the 4kiptvsubs team

TV guide illustration for adding an EPG URL to an IPTV player

You only need to add an EPG URL when you use an M3U playlist — apps that log in with Xtream Codes load the guide automatically. The EPG URL is usually sent with your subscription and, for Xtream-based services, ends in xmltv.php with your username and password. Paste it into your player's EPG settings, refresh, and set the time offset if listings are out.

Where to find the EPG URL

  • In the welcome message with your M3U link.
  • For Xtream-based services it typically looks like: http://server-address:port/xmltv.php?username=NAME&password=PASS
  • If you can't find it, ask your provider.

TiviMate

  1. Open Settings → EPG → Add EPG source.
  2. Paste the URL and save.
  3. Choose Update EPG to load it now.

With an Xtream Codes playlist, TiviMate adds the provider's EPG automatically.

IPTV Smarters

With an Xtream Codes login the guide loads automatically. With an M3U login, the app uses guide information included in the playlist where available; check for an EPG or Install EPG option in the Live TV section.

Kodi (PVR IPTV Simple Client)

  1. Add-ons → My add-ons → PVR clients → PVR IPTV Simple Client → Configure.
  2. Open EPG, set Location to Remote path, paste the XMLTV URL.
  3. Restart Kodi. Full steps: Kodi IPTV setup.

Smart TV apps (SET IPTV, IBO, Smart One)

Most add the EPG on the developer's website alongside your playlist, using your TV's MAC address — see SET IPTV and IBO Pro.

After adding the EPG

  • Refresh the guide.
  • Set the time offset if programmes are an hour or more out.
  • Hide unused groups so the guide loads faster.

If the guide stays empty

SymptomFix
Nothing loadsCheck the URL is complete; refresh
Some channels blankChannel IDs don't match the EPG data
Times wrongAdjust EPG offset / time zone

Full fixes are in IPTV EPG not loading. New to guides? Read what an EPG is and the M3U playlist guide.

FAQ

How to Add an EPG URL to Your IPTV Player — FAQ

Where do I find my EPG URL?

It's normally sent with your subscription alongside the M3U link. For Xtream-based services it usually ends in xmltv.php with your username and password.

Do I need an EPG URL with Xtream Codes?

Usually not. Apps that log in with Xtream Codes load the guide automatically. You mainly need a separate EPG URL with M3U playlists.

How often should the EPG update?

Once a day is typical. Many apps let you set the update interval; refresh manually after first setup.