How to Get EPG / XMLTV Guide URLs for IPTV
A technical resource on finding and using free XMLTV EPG URLs that actually match your channel list.
An EPG URL is the link that feeds TV guide data to your IPTV app. Without it you get a blank or generic guide; with the right one that matches your channel IDs, you get proper show titles, times and descriptions. The tricky part is finding free XMLTV sources that cover Albanian channels well and actually sync with your playlist.
What is an EPG URL for IPTV?
An EPG URL is a direct link to an XMLTV file that your IPTV player downloads to populate the program guide. XMLTV is a standard format that lists channels and their scheduled shows with start and end times. When you add an EPG URL in an app like IPTV Smarters Pro or TiviMate, the app fetches that file, compares channel identifiers in the XMLTV with the ones in your playlist, and fills the guide grid. If the IDs do not match, the channel stays blank.
Where to Find Free XMLTV EPG URLs
There are a few practical places to look for free guide data, each with trade-offs:
- Community projects. i.mjh.nz is a widely used free XMLTV source that covers many regions and is maintained by the community. Coverage varies by country and some listings may be automated.
- Provider supplied EPG. Some IPTV providers include an EPG URL alongside their M3U or Xtream Codes details. If yours does, start there first, as it is most likely aligned to your channel list.
- Original site XMLTV dumps. Certain broadcasters or third-party aggregators publish XMLTV dumps. These can be accurate but are often region-limited and may change or go offline without notice.
- xTeVe as a middle layer. xTeVe lets you combine multiple EPG sources, filter unwanted channels, and remap channel IDs so your guide matches your playlist. This is the single biggest fix for the blank guide problem.
For Albanian channels, coverage is still patchy. Our Albanian EPG and subtitles guide goes deeper into workarounds specific to that market.
What Makes a Good EPG URL
Not all free EPGs are equal. Look for these qualities when choosing one:
- Matches your channel IDs. This is non-negotiable. If your M3U uses custom IDs, no off-the-shelf XMLTV will line up unless you remap them.
- Correct timezone. Listings must align to the time zone you expect. Wrong offsets make shows appear hours off.
- Complete and current listings. Good sources update regularly. Stale guide data is worse than no data for many viewers.
- Reasonable size. Very large XMLTV files can take time to download on slower connections. Filtering unused channels helps.
If you are cleaning or inspecting playlists first, our M3U parser guide explains how channel IDs are structured and why they matter.
Free EPG Sources at a Glance
| Source | Free? | Covers key channels | Albanian channels |
|---|---|---|---|
| i.mjh.nz (community XMLTV) | Yes | Good for many international regions | Partial - varies by feed |
| Your IPTV provider | Usually | Best match to your playlist | Often best if included |
| Original broadcaster XMLTV | Varies | Strong for specific channels | Limited availability |
| xTeVe merged feeds | Yes | Customizable to your list | Can combine multiple sources |
Many so-called "premium EPG" products simply repackage free data. The value is usually in curation, ID mapping, or uptime, not in secret listings. Quantity of channels rarely beats correct alignment.
How to Add an EPG URL to Your IPTV App
Where the EPG URL field lives depends on the app you use:
- IPTV Smarters Pro. When adding a new service via Xtream Codes API or a Playlist URL, there is an "EPG URL" field. Paste your XMLTV guide URL there. You can also update it later in the app settings.
- TiviMate. Add your EPG source under EPG settings, then assign it to your playlist. TiviMate allows multiple EPG sources and is flexible with mappings.
- Smart IPTV. EPG is configured via the Smart IPTV portal or the app's EPG settings depending on your version. Check your app documentation for the exact field name.
If you are starting from scratch or want to customize your list, see how to build your own M3U playlist and the full IPTV EPG setup guide for step-by-step instructions.
Troubleshooting: Fixing a Blank or Wrong Guide
If your guide is empty or shows wrong times, work through these checks:
- Check channel mapping. The classic failure is ID mismatch. Use xTeVe or your app's mapping tool to align playlist IDs with XMLTV IDs.
- Refresh the EPG. Force a manual EPG refresh in your app. XMLTV files are cached and may be stale.
- Verify the URL. Open the EPG URL in a browser; if it downloads a .xml or shows XML, it is reachable. If it times out, try another source.
- Check timezone. Ensure your app's timezone matches your location or the guide's intended zone.
- Test coverage. Some channels simply lack data in free feeds. Focus on the channels you actually watch.
For broader health checks on your playlist, read IPTV playlist health. If buffering is also an issue, how much internet speed for IPTV is worth reviewing alongside guide fixes.
Conclusion
The best approach is to start with your provider's EPG URL if available, fall back to i.mjh.nz for free coverage, and use xTeVe to remap IDs when things do not line up. Prioritize correct channel matching and timezone over raw quantity. With those basics right, your guide will stay populated and accurate. If you want a ready-to-go service that includes properly aligned guide data, explore Vivo IPTV plans.