On this page (9)
EPG data is a schedule file, usually in XMLTV format, that lists each channel’s programmes with start and end times, titles and descriptions, and your IPTV player matches it to your channels using an ID so the guide knows what is on where.
The TV guide looks simple on screen, but behind it is a large data file that must be generated, delivered, downloaded and matched correctly. When any part goes wrong, you see empty rows, wrong times or the wrong programmes. This article explains how guide data works from start to finish.
Where Guide Data Comes From
Broadcasters publish schedules, and guide providers collect them for thousands of channels across many countries. They convert the information into a standard format and update it regularly as schedules change.
The XMLTV Format
XMLTV files contain two main parts:
- Channel entries: each with an ID, display name and sometimes a logo.
- Programme entries: each with a channel ID, start and stop times including time zone offset, title, description and optional details such as category or episode number.
How the Player Matches Channels
| Playlist | Guide | Result |
| tvg-id matches channel ID | Programmes exist | Guide shows correctly |
| tvg-id missing | – | Player tries to match by name, may fail |
| tvg-id points to another region | Different schedule | Wrong programmes |
| Correct ID | No programmes listed | Empty row |
Time Zones in Guide Data
Each programme time includes an offset from UTC. Your player converts it to your device’s local time. If the device time zone is wrong, the whole guide shifts. If the source data has a wrong offset, specific channels shift, which is why many players offer a guide time offset setting.
Size and Updates
A guide covering thousands of channels for a week can be a large file. Players download it periodically, often daily, and store it in a local database. Low-memory devices can struggle with very large guides, which is why limiting the number of days helps.
Xtream Logins and the Guide
With Xtream Codes logins, the provider usually supplies guide data matched to its channels automatically. With M3U playlists, the guide link may be in the playlist header or entered separately.
Common Problems Explained
- “No information”: no matching guide entry for that channel.
- Guide ends after a day or two: the source covers a short period or updates failed.
- Everything an hour off: time zone or daylight saving setting.
- Catch-up plays the wrong show: guide times do not match the archive.
Frequently Asked Questions
Can I use more than one guide source?
Some players merge several sources to fill gaps.
Why do some channels never have guide data?
Smaller or event channels may not have published schedules.
How often should the guide update?
Once every 12 to 24 hours suits most setups.
The Schedule Behind the Screen
Guide data is a matching exercise between channels, IDs and times. Understanding it makes most guide problems easy to fix. For the channel list side, read what an M3U playlist is, or see the IPTVX IPTV plans.
