How to Add XMLTV EPG to IPTV
Step-by-step XMLTV setup for IPTV players. Add the EPG URL, map channels, and verify the guide loads correctly.
How do I add XMLTV EPG data to IPTV?
Quick Answer: Copy your provider's XMLTV URL, paste it into the EPG or guide settings of your player, then refresh and map channels if needed.
XMLTV is separate from your M3U. You need both for a working guide.
XMLTV is the most common format for IPTV EPG data. This guide walks you through adding the XMLTV URL, refreshing the guide, and mapping channels so program data appears correctly.
Find the correct XMLTV URL
Most IPTV providers supply an XMLTV URL alongside your playlist. If you have multiple URLs, use the one labeled XMLTV or EPG. Test it in a browser before adding it to your player.
Add XMLTV in your player
Open the player settings, locate the EPG or guide section, and paste the XMLTV URL. Save the settings and trigger an EPG refresh.
Map channels and verify data
If the guide loads but some channels are missing, map tvg-id values manually. Most players include a channel mapping screen for this step.
Tune refresh and cache settings
Set the refresh interval to 12 or 24 hours and clear the EPG cache after changes. This keeps data fresh without slowing your player.
Frequently Asked Questions
Is XMLTV required for IPTV?
It is not required for playback, but it is required for program guides, schedules, and DVR features.
Can I use a third party XMLTV source?
Yes, but matching tvg-id values can be harder. Provider XMLTV sources are usually the best match for your playlist.
Why does XMLTV load but show no programs?
The most common cause is missing or mismatched tvg-id values. Align your playlist metadata with the XMLTV file.
Related Guides
How to Setup EPG (TV Guide) for IPTV - Complete Tutorial
Learn how to setup and configure EPG (Electronic Program Guide) for your IPTV player. Step-by-step instructions for TiviMate, IPTV Smarters, Kodi, and more.
EPG Not Loading? Fix Empty IPTV Guide Grids
Fix EPGs that show a blank grid or never load. Verify XMLTV URLs, match tvg-id values, and refresh guide data the right way.
EPG Time Offset Fix - Correct IPTV Guide Times
Fix IPTV EPG schedules that appear hours ahead or behind. Adjust timezone offsets, device clock settings, and provider XMLTV time shifts.
Works with these apps
TiviMate
Premium IPTV player with EPG and recording
IPTV Smarters Pro
Cross-platform IPTV player with Xtream support
Perfect Player
Set-top box style IPTV player for Android
OTT Navigator
Powerful IPTV player with Stalker and Xtream support
Compatible devices
Firestick
Affordable streaming stick with Alexa
Android TV
Versatile streaming boxes running Android TV
Samsung TV
Samsung Smart TVs with Tizen OS
Written by
IPTV Guide Team
IPTV & Streaming Specialists