EPG Guide Setup: Get TV Listings on Your IPTV Player

An Electronic Program Guide turns your IPTV player from a list of numbered channels into something that resembles a real TV experience. Without EPG, you are guessing what is on every channel. With EPG, you see current and upcoming programs, descriptions, airing times, and often genre classifications. It is the difference between scanning radio frequencies hoping to find something good and reading a TV listings magazine.

Setting up EPG correctly is the step most IPTV users either skip or get wrong. This guide covers the underlying technology, the setup process for every major player, and the fixes for common problems that prevent EPG data from appearing.

What Is EPG and How Does It Work?

EPG stands for Electronic Program Guide. In the IPTV context, EPG data is delivered as an XMLTV file, which is an XML-formatted document containing program schedule information for channels. Each channel entry in the XMLTV file includes a channel ID, channel name, and a list of programs with start times, end times, titles, descriptions, and optional metadata like categories, ratings, and episode information.

The XMLTV file can be massive. A comprehensive EPG covering 20,000+ channels with 7 days of programming data can exceed 500 MB uncompressed. For this reason, EPG files are typically served in gzip-compressed format (.xml.gz). Your IPTV player downloads the compressed file, decompresses it, parses the XML structure, and matches channel entries against your playlist using channel IDs.

The matching process is critical. Each channel in your M3U playlist has a tvg-id attribute (e.g., tvg-id="BBC1.uk"). The XMLTV file contains channel definitions with corresponding IDs (e.g., channel id="BBC1.uk"). When these IDs match, the player displays the correct program data for that channel. When they do not match, the channel shows no EPG data even though the guide information exists in the file.

EPG with Xtream Codes vs M3U

How you receive EPG data depends on your connection method. With Xtream Codes, EPG is integrated into the API. Your player requests guide data through the /xmltv.php endpoint, and the provider's server handles channel-to-EPG matching internally. This means EPG generally works out of the box with zero configuration. The provider ensures that channel IDs in their system match the EPG data they serve.

With M3U playlists, EPG requires a separate XMLTV URL that you must configure manually in your player. The matching between playlist channel entries and EPG data depends on the tvg-id attributes in the M3U file lining up with the channel IDs in the XMLTV source. If your provider generates both the playlist and the EPG source (as IPTVPlaylist does), matching is typically reliable. If you use a third-party EPG source, matching inconsistencies are common.

Setting Up EPG in TiviMate

For Xtream Codes connections: EPG loads automatically. Navigate to the TV Guide section and verify that program data appears. If it does, no further configuration is needed.

For M3U connections or to add a supplemental EPG source: go to Settings > Playlists > select your playlist > EPG Sources. Tap Add EPG Source. Enter the XMLTV URL provided by your IPTV provider. IPTVPlaylist includes this URL in your welcome email. Tap OK and then Update EPG. TiviMate downloads and processes the EPG data in the background. The initial download for a full EPG can take 3-10 minutes depending on your device and connection speed.

Configure the update interval under the same EPG Sources menu. Set it to 12 hours for most providers. EPG data typically covers 24-72 hours of programming and is updated 1-2 times daily at the source. More frequent updates waste bandwidth without providing fresher data.

If specific channels show no EPG data despite the EPG source being loaded, the tvg-id mapping may be incorrect. In TiviMate, you can manually map channels: long-press on a channel, select EPG, and search for the correct channel in the EPG database. This manual mapping persists across EPG updates.

Setting Up EPG in IPTV Smarters Pro

Xtream Codes connections load EPG automatically through the API. Verify by checking the now/next information bar during channel playback.

For M3U connections: navigate to Settings > EPG. Enter your XMLTV URL in the EPG Source field. Tap Save, then tap Update EPG to trigger the initial download. The processing time varies by device but expect 5-15 minutes for a full EPG on mid-range hardware.

IPTV Smarters Pro does not provide manual channel-to-EPG mapping tools. If channels show no EPG, the issue must be resolved at the source (incorrect tvg-id in the playlist or missing channel in the EPG data). Contact your provider if specific channels consistently lack program data.

Setting Up EPG in Kodi (PVR IPTV Simple Client)

Open Kodi, go to Settings > Add-ons > My Add-ons > PVR Clients > PVR IPTV Simple Client > Configure. Navigate to the EPG Settings tab. Set XMLTV URL to your EPG source URL. Set the cache mode to Once Per Day to minimize bandwidth usage.

Restart Kodi after saving the EPG settings. The PVR system downloads and indexes the EPG data during startup. You can monitor the progress in System > Events. Once loaded, EPG data appears in the TV Guide section (accessible from the home screen or through the TV menu).

Kodi's PVR system provides the most detailed EPG display among IPTV players, showing full program descriptions, categories, cast information (if available in the XMLTV data), and series/episode details. The EPG grid view is navigable with both remote controls and keyboard/mouse.

Setting Up EPG in VLC

VLC does not support EPG natively. There is no built-in mechanism for loading XMLTV data or displaying program guides. VLC treats M3U playlists as simple media lists and provides no TV-like guide functionality. This is one of VLC's primary limitations as an IPTV player. If EPG is important to your workflow, consider using a dedicated IPTV player alongside VLC.

Troubleshooting: EPG Not Showing

EPG issues fall into a few distinct categories. Work through them systematically.

EPG source fails to download: Verify the XMLTV URL by opening it in a web browser. It should download a .xml or .xml.gz file. If you get an error, the URL may be incorrect, expired, or the server may be down. Check with your provider for the current EPG URL.

EPG downloads but no channels show program data: This is a matching problem. The tvg-id values in your M3U playlist do not correspond to the channel IDs in the XMLTV file. Solutions: use Xtream Codes instead (matching is handled server-side), ask your provider for a compatible EPG source, or manually map channels in players that support it (TiviMate, OTT Navigator).

EPG shows for some channels but not others: Partially working EPG indicates the source is valid but does not cover all channels in your playlist. This is common with large playlists spanning 100+ countries. Some regional channels may lack EPG data in any available source. This is a provider-side limitation.

EPG shows wrong program data: Channel IDs are mapped to the wrong XMLTV entries. This happens when similar channel IDs exist in the EPG source (e.g., BBC1 vs BBC1.HD vs BBC1.uk). Manual remapping in TiviMate or OTT Navigator resolves this.

EPG loads very slowly or crashes the player: The XMLTV file is too large for your device to process. Solutions: use Xtream Codes (loads EPG on demand), use a lighter EPG source with fewer days of data, or upgrade to a device with more RAM (2GB minimum, 4GB recommended for large EPGs).

EPG Best Practices

• Use Xtream Codes when possible for automatic EPG handling
• Set EPG refresh to every 12-24 hours, not more frequently
• On low-RAM devices, consider Xtream Codes to avoid downloading the full XMLTV file
• Match your M3U and EPG sources from the same provider for best ID compatibility
• After adding EPG, wait for the full processing cycle before troubleshooting missing data
• Use manual channel mapping in TiviMate or OTT Navigator for stubborn mismatches

Get Reliable EPG with IPTVPlaylist

IPTVPlaylist includes comprehensive EPG data covering all 29,500+ live channels. EPG URLs are provided alongside your M3U and Xtream Codes credentials. With Xtream Codes connections, EPG loads automatically with zero configuration. Visit /pricing to get your subscription, and check /features for full details on EPG coverage, channel counts, and VOD library. Step-by-step EPG setup for your specific device is available at /setup-guide.