Missing Kodi IPTV EPG: Verify XMLTV Source and M3U Channel tvg-id
Kodi’s IPTV Simple Client shows an empty or shifted Electronic Program Guide when its data sources are misaligned. This article explains how to diagnose and resolve these issues by verifying that your M3U tvg-id values match the XMLTV source perfectly.

Understanding the Logic of Program Assignment
The IPTV Simple Client add-on for Kodi relies on two distinct but interconnected data inputs: the M3U playlist, which defines the media streams, and the XMLTV file, which contains the program grid. The extension does not generate broadcast content automatically; instead, it attempts to associate each playlist entry with a corresponding guide entry using common identifiers. When this matching process fails, Kodi retains the channels in your list but displays an empty grid or schedules shifted by several hours.
Therefore, it is essential to verify that the data source provided by your provider is coherent. A total absence of program data should not be confused with a simple clock synchronization error. The first step in troubleshooting is to examine the menus within the specific version of the extension installed on your system, as options can vary slightly depending on your distribution.
The Critical Match Between tvg-id and M3U
Official documentation from the Piers branch of the kodi-pvr/pvr.iptvsimple GitHub repository clarifies that the algorithm prioritizes the exact match between the channel identifier in the XMLTV and the tvg-id attribute present in the M3U playlist. This mechanism ensures a direct relationship but demands absolute rigor in string matching.
Here are the essential checks for debugging this association:
- Verification of Unique Identifiers: Each #EXTINF line in your M3U file must contain a tvg-id="..." attribute that exactly mirrors the value used in the <channel id="..."> tag of the XMLTV file. Even a minor difference, such as an extra space or a hyphen, can break the link.
- Case Sensitivity Management: Depending on the version of the extension deployed on your system, the engine may be case-sensitive or case-insensitive. If your tvg-id contains uppercase letters while your XMLTV uses lowercase (or vice versa), the association will fail. You should normalize both files to use an identical convention.
- Utilizing tvg-name: In the event that identifier matching fails, the extension may attempt a secondary match via channel names (tvg-name or group-title). However, this method is less reliable because names often contain spacing variations or text differences that prevent automatic recognition.
Fine Adjustments and Data Sources
Once the integrity of the identifiers is verified, you should examine the regional settings of the extension. The official wiki mentions the existence of time-shift settings. If your XMLTV file originates from a service based in a different time zone than your location, programs may appear several hours ahead or behind, creating the impression that the EPG is inactive.
It is also recommended to request a coherent XMLTV file from your provider before making any technical modifications to the identifiers. Manually altering tvg-id values in the M3U playlist to force a match is a last-resort solution, as a typo will permanently render the channel incompatible with the guide.
In summary, the absence of an EPG in Kodi is rarely a software bug. It is usually a symptom of a break in the identification chain between your structured data. By rigorously aligning your M3U tvg-id with your XMLTV source and validating case sensitivity options, you can restore guide functionality without resorting to unofficial patches.