An EPG URL path is the web link your IPTV player loads to fill its on-screen TV guide with program schedules. Setting it correctly is what separates a working “now and next” grid from an empty one. In this guide you will learn what the URL is, the formats it comes in, how to find or build the right one, and how to add it to popular players. You will also see how to fix the most frequent problems, from blank guides to incorrect program times.
What Is an EPG URL Path?
An EPG (Electronic Program Guide) URL path points to an XMLTV file, a data file that lists channels along with their broadcast schedules. Your player downloads this file so it can display what is showing on each channel now and later.
This link is not the same as your playlist or M3U URL. The playlist tells the app which channels and streams exist, while the EPG URL tells it what is playing on those channels. Each one goes into a different field inside the player.
EPG files arrive in two formats: plain .xml and compressed .xml.gz. The gzip version stores the same information in a smaller file, so it downloads faster and is the smarter pick when a provider offers both.
Types of EPG URL Paths (and How to Build Each)
Almost every link you come across fits one of three patterns.
Xtream Codes EPG Path (xmltv.php)
If you sign in with an Xtream Codes username and password, your guide link uses the xmltv.php path:
http://domain:port/xmltv.php?username=USERNAME&password=PASSWORD
Only the username and password are required. Many Xtream based apps load this guide on their own, but you can still assemble the link by hand whenever a player asks for it.
Direct XMLTV File URLs (.xml and .xml.gz)
Some providers host a prepared guide file and hand you a direct link that ends in .xml or .xml.gz. You paste that link straight into the EPG field. These direct links are common when a service runs on M3U playlists rather than an Xtream login.
Public / Free EPG Source URLs
When your provider gives you no guide, or a weak one, you can turn to a free community source that publishes XMLTV files sorted by country or region. These sources work well, though the channel names inside them still need to line up with your own channels, which the ID matching section explains.
| URL Type | Format | Where It Comes From | Best For |
|---|---|---|---|
| Xtream Codes | xmltv.php link | Built from your login details | Xtream username and password setups |
| Direct file | .xml or .xml.gz | Provider dashboard or email | M3U playlist setups |
| Public source | .xml or .xml.gz | Free community EPG site | Filling gaps in provider data |
How to Find Your EPG URL Path
Your EPG link normally comes from one of three sources. Providers often include it in the welcome email or account dashboard, listed separately from your playlist link.
If you hold an Xtream Codes login, you can create the link yourself. Take your M3U URL, swap get.php? for xmltv.php?, and delete the trailing &type=m3u_plus&output=ts. A third route is to copy a ready made link from a free EPG source.
Before you save any link, paste it into a web browser. A valid URL loads XML text or downloads a file, while a broken or expired one returns an error.
How to Add an EPG URL to Your IPTV Player
The routine is similar across apps: open settings, locate the EPG or playlist area, paste the XMLTV URL, choose a refresh interval, and run an update. Here is how that plays out in the most widely used players.
IPTV Smarters Pro
Open Settings, select EPG, and tap Add EPG. Paste your XMLTV URL, give it a clear label, and force a refresh. With an Xtream login the guide often appears automatically, while M3U setups need the URL entered by hand.
TiviMate
Open Settings, go to Playlists, and select your playlist. Choose EPG sources, tap Add URL, and paste the XMLTV link. Set the Update Period to 6 or 12 hours, then run Update EPG Now.
Other Players (Firestick apps, Apple TV / iPlayTV, Smart STB)
Most Firestick apps follow the same settings pattern shown above. Keep in mind that some players, such as iPlayTV on Apple TV, do not fetch the guide automatically from an Xtream server, so you have to type the EPG URL into the playlist settings yourself.
Match Channel IDs So the Guide Populates
The leading reason a guide stays empty is a channel ID mismatch. The XMLTV file tags each channel with channel id="...", and your playlist tags each channel with tvg-id="...". These two values have to match exactly, or the app cannot connect a channel to its schedule.
You can review the outcome inside your player. TiviMate lists matched channels under Settings, EPG, Matched Channels, while IPTV Smarters shows matched and unmatched counts in its EPG Sources area.
When channels fail to match, you have three practical fixes:
- Map the channel by hand in the player’s channel editor.
- Edit the
tvg-idin your M3U so it matches the source. - Ask your provider to correct the channel IDs.
Fix Common EPG URL Problems
Most guide issues trace back to a small set of causes. Use the table for a fast reference, then apply the detailed fixes below.
| Symptom | Likely Cause | Fix |
|---|---|---|
| Blank guide | ID mismatch or bad URL | Verify the URL, then match the IDs |
| Wrong times | Timezone offset error | Adjust the time offset setting |
| Guide not updating | Long interval or cached data | Force a refresh, clear the cache |
Guide Is Blank (“No Information Available”)
This message usually means the channel IDs do not match, or the URL is wrong, expired, or unreachable. Confirm the link loads in a browser, then check that your tvg-id values match the source before trying anything else.
Program Times Are Wrong
XMLTV stores times in UTC with an offset such as 20260501100000 +0000. If your player misreads that offset, the guide shifts hours ahead of or behind the real schedule. Correct it with the app’s Time Offset or Time Shift option, moving in one hour steps until the times match your local clock, and watch for daylight saving changes.
EPG Won’t Refresh or Update
If the guide never changes, the refresh interval may be set too long, auto update may be switched off, or the local cache may be corrupted. Force a manual refresh, clear the EPG cache to trigger a clean download, enable auto update, and set an interval between 6 and 12 hours.
Best Practices for a Reliable On-Screen Guide
A few simple habits keep your guide accurate and steady:
- Pick the
.xml.gzlink when it is offered, since it downloads faster. - Keep one trusted EPG source per playlist to avoid conflicts.
- Set a reasonable refresh interval, such as 6 to 12 hours, instead of constant updates.
- Test every URL in a browser before you save it.
- Keep your provider’s own guide when it is accurate rather than stacking extra sources on top.
Frequently Asked Questions
What is an EPG URL and where do I find mine?
An EPG URL is the link your IPTV player loads to display program schedules. You find it in your provider’s welcome email or account dashboard, or you build it from your Xtream Codes login details.
How do I turn my M3U link into an EPG link?
Replace get.php? with xmltv.php? in your M3U URL, then remove &type=m3u_plus&output=ts from the end. The result is your Xtream Codes EPG URL, which needs only your username and password.
Why does my IPTV guide say “No information available”?
The guide is blank because the channel IDs in your playlist do not match the IDs in the XMLTV source. Confirm the EPG URL loads, then align each tvg-id with its matching channel id.
How do I fix wrong program times on my TV guide?
Wrong times come from a timezone offset error between the UTC based XMLTV file and your player. Open the app’s Time Offset or Time Shift setting and adjust in one hour steps until the schedule matches your clock.
Should I use the .xml or .xml.gz EPG URL?
Use the .xml.gz link when it is available. It holds the same guide data in a compressed file, so it downloads faster and updates more smoothly, which helps on memory limited devices like streaming sticks.
How often does the EPG update and how do I force a refresh?
Most guides refresh every 6 to 12 hours, based on your interval setting. To force an update, use options such as Update EPG Now in TiviMate or Force Refresh in IPTV Smarters.
Conclusion
Using an EPG URL path comes down to three steps: get the correct XMLTV link, add it in the right field, and make sure your channel IDs match the source. When those line up, your on-screen guide will show accurate now and next data across your channels. If a problem does appear, it almost always traces back to a wrong URL, mismatched IDs, or a timezone offset, and each of those is quick to correct.