How to Integrate XMLTV with IPTV and Live TV Players An Electronic Program Guide (EPG) is the backbone of a great live TV streaming experience. Without it, you are left channel surfing blindly without knowing what is currently airing or playing next. XMLTV is the universal, open standard format used to deliver this guide data to your media player.
Integrating an XMLTV file with your IPTV player populates channel logos, program descriptions, genres, and schedules. This guide will walk you through exactly how to set up XMLTV across various live TV platforms. 🛠️ Step 1: Obtain Your XMLTV URL or File
Before opening your IPTV player, you need the actual guide data. IPTV providers usually supply this, but you can also generate your own.
Provider M3U/EPG URL: Most commercial IPTV services provide two URLs: one for the video playlist (.m3u) and one for the guide data (.xml or .gz). Copy the EPG/XMLTV URL exactly as given.
Self-Generated XMLTV: If you use over-the-air antennas or premium services without a guide, tools like WebGrab+Plus, XMLTV Guide, or EPG.best can scrape listings and generate a custom XMLTV file.
Local vs. Remote: Whenever possible, use a remote URL link rather than a downloaded local file. Remote URLs allow your IPTV player to automatically update the guide daily. 📺 Step 2: Integrate XMLTV with Popular IPTV Players
Every IPTV player handles data ingestion slightly differently. Here is how to map your XMLTV guide on the most popular applications. Tivimate (Android TV & Fire TV)
Tivimate is widely considered the gold standard for live TV customization. Open TiviMate and navigate to Settings > EPG. Click on EPG Sources and select Add Source.
Choose URL and enter your XMLTV link (or select local file if stored on the device).
Click Next and give the source a name (e.g., “My EPG Provider”).
Return to Settings > Playlists, select your active playlist, scroll down to EPG Source, and ensure your newly added XMLTV source is selected. IPTV Smarters Pro (Android, iOS, Windows, Mac) Smarters Pro is highly accessible and cross-platform.
Launch the app and select Add User or log in with your existing playlist.
If logging in via M3U URL, you will see a field explicitly labeled EPG URL. Paste your XMLTV link there.
If you are already logged in, click Install EPG on the main dashboard screen.
Enter your XMLTV link and click Import EPG. The app will take a few moments to parse the program listings. OTT Navigator (Android & Android TV)
OTT Navigator offers deep technical customization for power users. Open the side menu and go to Settings > Providers. Click on your active IPTV provider playlist. Scroll down and select EPG Sources. Choose Add Source and paste your XMLTV URL.
Trigger a manual sync by clicking Apply or restarting the app. 💻 Step 3: Integrate XMLTV with Home Media Servers
If you manage your live TV through a centralized home server, the XMLTV integration happens on the backend. Plex Media Server
Plex allows you to map XMLTV data directly to your tuner or IPTV proxy setup (like xTeVe).
Go to your Plex Web Dashboard and navigate to Settings > Live TV & DVR. Click Set Up DVR or access your existing tuner settings.
When prompted for a guide provider, select Have an XMLTV guide on your server?. Paste your XMLTV file path or remote URL.
Match the XMLTV channels manually to your tuner channels if Plex does not auto-map them. Jellyfin / Emby
Both Jellyfin and Emby handle IPTV natively with great EPG support. Open the Admin Dashboard and click on Live TV.
Under the Guide Providers section, click the + (Add) button. Select XMLTV as the provider type.
Enter the file path or remote HTTP URL of your XMLTV source.
Save the settings and click Refresh Guide Data to pull in the listings. ⚠️ Troubleshooting Common XMLTV Issues
Setting up an EPG can occasionally result in blank guides or mismatched channels. Use these quick fixes to resolve issues:
Mismatched Channel IDs: IPTV players match video streams to EPG data using a specific tag called tvg-id or channel-id. If your channel names do not match perfectly between your M3U playlist and your XMLTV file, the guide data will show up blank. Many players (like TiviMate) allow you to long-press a channel and manually assign an EPG stream to it.
Incorrect Time Zones: If the guide shows the right show but at the wrong hour, your time zone offset is incorrect. Check your IPTV player’s EPG settings for a Time Shift feature. You can adjust this by adding or subtracting hours (e.g., +1.00 or -5.00) until the guide matches real-world time.
Cached Data Glitches: If your guide stops updating, the local cache may be corrupted. Go into your player’s settings, click Clear EPG Cache, and force a manual update/refresh to download a clean copy of the XMLTV file. To ensure your guide stays accurate, tell me:
What media player or device are you currently trying to set up?
Are you using a commercial IPTV service or mapping your own custom channel lineup?
I can provide tailored instructions or troubleshooting steps for your exact setup.