IPTV EPG Guide: What It Is, How to Set It Up, and Fix Guide Problems
An EPG, or Electronic Program Guide, is the schedule data that fills the TV guide inside your IPTV app. Without an EPG you can still watch channels, but you cannot see what is airing next, set reminders, or browse programming by time. This guide explains how IPTV EPG data works, how to load it into common apps, and how to fix the most frequent guide problems. What Is an IPTV EPG? An EPG is a structured list of programs with start times, end times, and descriptions for each channel. On traditional TV, this data is carried in the broadcast signal itself. IPTV does the same thing, except the schedule is delivered as a separate data feed that your app downloads and matches to your channels. The most widely used format for IPTV EPG data is XMLTV. An XMLTV file uses a channel ID and a program list to organize schedules. When your IPTV app loads this file, it pairs each program with the matching channel by the channel’s tvg-id, which is defined inside your M3U playlist. In other words, the M3U playlist names the channels, and the EPG supplies the schedule for those names. Where IPTV Providers Send the EPG Data Providers deliver EPG data in one of three ways. The most common is a direct EPG URL in XMLTV format, often compressed as .xml.gz to keep the file small. Some providers include the EPG URL next to your M3U playlist in their customer portal. Others hard-code the EPG link inside the app they distribute. A growing number of providers use an API-based system where the app pulls the schedule automatically once the account is linked. If your provider only sent an M3U link, check your account dashboard for an EPG section. Many subscribers miss it, and that is the single most common reason the guide stays empty after channels load correctly. How to Add an EPG URL to Popular IPTV Apps Adding EPG in TiviMate TiviMate loads its guide from an EPG source you add under Settings > TV guide. You can add multiple EPG sources in the same way you added your playlist: choose Add EPG source, give it a name, and paste the XMLTV URL. After saving, TiviMate downloads the schedule and matches channels automatically. If a channel still shows no data, manually map it to a channel ID in the app’s channel settings. Adding EPG in IPTV Smarters Pro IPTV Smarters Pro normally pulls the EPG from the provider’s API when you log in. If you are using a plain M3U setup, look for an option to add an EPG URL in the app’s settings. Availability depends on the version, so check the app’s documentation if the option is not visible. Using EPG with Standalone Players Like VLC VLC has its own program guide feature for supported streams, but it cannot absorb an external XMLTV file the way IPTV apps do. If EPG matters to you, use a dedicated IPTV app on your device instead of a general media player. Our Fire TV Stick setup guide and our Windows IPTV player guide point you to apps that handle EPG properly. Common EPG Problems and How to Fix Them The Guide Is Empty Even Though Channels Work Most often this means the app has no EPG source, or the source has not been added yet. Confirm the EPG URL was entered, then refresh the guide. If you are using a provider app that manages its own EPG, make sure your account is logged in and the subscription is active. Some Channels Show Program Info and Others Do Not This is a channel matching problem. Programs are tied to channel IDs, and a channel with no matching ID in the XMLTV file stays blank. In apps like TiviMate you can fix this by assigning the correct channel ID manually. The IDs are printed on the tvg-id attribute of each channel in your M3U playlist. The Schedule Times Are Wrong IPTV schedules are delivered in UTC. Most apps convert to your local time automatically, but if your device timezone is set incorrectly, every listing shifts by a fixed number of hours. Check the timezone in your device settings and in the app, then refresh the guide. This is the most common cause of “the times are all wrong” complaints. The EPG File Stops Updating Apps refresh the guide on an interval, and a cached schedule can go stale. Force a refresh in the app, or fully close and reopen it. If you use an XMLTV URL, confirm it still works by opening it in a browser. Providers occasionally rotate EPG links just as they rotate playlist links. The EPG Download Fails or Fails to Parse A partial download or a corrupted compressed file produces exactly this result. Clear the app cache, re-add the EPG source, and try again. If the problem continues, ask the provider for a working EPG URL or an updated one, since the endpoint may have changed. Improving the Guide: Merge Sources and Set Refresh Times If you want the most complete schedule, many IPTV apps let you add multiple EPG sources at once and merge them. This is useful when a provider’s built-in EPG is thin but a public XMLTV feed covers the same channels. Within the app you can also decide how often the schedule refreshes. A refresh interval of 24 hours is usually enough for live TV; choosing a very short interval wastes bandwidth and can look like abusive polling to the provider. IPTV EPG FAQ Do I need an EPG to watch IPTV?No. EPG only fills the guide. Channels play without it, but you lose the ability to browse what is coming next, set reminders, or jump to programs directly. What is the difference between an EPG and a category?A category is a grouping in your playlist, such as Sports, News, or Movies. An EPG is schedule data. Categories organize the channel list; an EPG organizes the guide. Can I make