
EPG in IPTV stands for Electronic Program Guide. It is the on-screen schedule that tells you what is playing now, what starts next, and what will air later on each live channel. A useful EPG can show programme titles, start and finish times, episode details, genres, descriptions, channel logos and catch-up availability. It turns a long playlist into a familiar television guide instead of forcing you to open channels at random.
The guide is separate from the video stream. Your M3U playlist or provider login supplies the channels, while an EPG source supplies schedule metadata. Most IPTV players download that metadata, store it temporarily, and match each guide channel to a playlist channel. XMLTV is the most common exchange format. Xtream-style logins can also deliver guide data automatically, although the player still has to match the records correctly.
When I troubleshoot a blank guide, I check the data path before blaming the stream. A channel can play perfectly while its EPG remains empty because the guide URL expired, the channel identifiers do not match, the app cached an old file, or the timezone is wrong. Understanding that separation makes EPG problems much easier to diagnose.
Key EPG features:
- Now and Next: See the current programme and the following show without leaving the channel list.
- Schedule Grid: Browse several channels across a timeline that may cover hours or multiple days.
- Programme Details: Read descriptions, episode names, categories, ratings and other metadata when the source includes them.
- Search and Reminders: Find programmes by title and set alerts in players that support those features.
- Catch-Up Access: Open a past guide item when both the provider and player support an archive window.
A good EPG does not improve picture quality or make an unreliable stream stable, but it dramatically improves navigation. The rest of this guide explains how EPG data works, how to add it, and how to fix the failures that IPTV users encounter most often.
What Information Does an IPTV EPG Show?
An EPG is a structured database of channels and programme events. The exact fields depend on the guide supplier and what your player chooses to display. A basic source may provide only titles and times, while a richer one can make live television feel close to a cable or satellite guide.
Channel Identity
Each guide channel has an identifier and one or more display names. That identity lets the player connect schedule records to the correct stream, even when viewers rename or reorder channels in the interface.
Programme Start and Stop Times
Every event normally includes a start time, an end time and a timezone offset. The player converts those values to the device timezone and places the programme in the correct position on the grid.
Title and Episode Name
The main title identifies the programme. A subtitle can identify a particular episode, news edition or sporting fixture, helping search and recording tools distinguish similar entries.
Description and Category
Guide sources may include summaries and categories such as news, drama, sport or children. Players can use categories for filters, colour coding and parental-control decisions.
Season, Episode and First-Aired Date
Richer XMLTV feeds can include season and episode numbering, original air dates, credits and ratings. These fields are optional, so an empty value does not necessarily indicate a setup fault.
Channel and Programme Artwork
Channel logos and programme images can come from the playlist, the guide, or the player database. Players apply different priority rules, which explains why artwork may appear even when schedule text does not.
Catch-Up and Recording Context
The guide provides the time boundaries that catch-up and recording features use. It does not store the archived video itself; playback works only when the provider supplies a compatible archive or DVR stream.
How EPG Data Reaches Your IPTV Player
The process begins with a schedule source. A broadcaster, listings supplier, IPTV platform or guide-grabber collects programme information and publishes it in a machine-readable form. XMLTV files contain channel records plus programme records with start, stop and channel attributes. Some services provide a direct XML or compressed XML URL. Others expose the same information through an account API after the player authenticates.
Your IPTV app downloads the guide separately from the live playlist, parses the records and saves them in a local database. It then compares each guide identifier with the metadata attached to each stream. When a match succeeds, the app displays the current and upcoming programmes beside that channel. A scheduled refresh replaces expired events and adds future listings.
- Guide Publisher: Creates or aggregates channel schedules and assigns stable identifiers to guide channels.
- Delivery URL or API: Makes the XMLTV file or guide response available to the authorised account.
- IPTV Player: Downloads, parses and caches the listings without changing the underlying video stream.
- Channel Mapper: Links playlist metadata to the corresponding channel record in the guide source.
- Guide Interface: Converts matched events into a now-and-next list, grid, search index or reminder screen.
This chain explains why one stage can fail while the others keep working. A valid stream URL proves only that the video endpoint responds; it says nothing about the freshness, mapping or completeness of the guide data.
XMLTV, M3U and Xtream Codes: What Each One Does
These three terms are often mixed together, but they describe different parts of an IPTV setup. An M3U file lists streams and channel metadata. XMLTV stores television listings. An Xtream-style login gives a compatible app structured access to account information, channel groups, VOD and guide responses. A subscription may provide all three.
In an extended M3U entry, attributes such as tvg-id, tvg-name, tvg-logo and group-title describe the channel. Kodi IPTV Simple, for example, uses tvg-id as the first match against the XMLTV channel ID, then tries names when necessary. The XMLTV programme record points back to that channel ID and carries its title, times and description.
- M3U Playlist: Tells the player which streams exist and attaches identifiers, names, logos and channel groups.
- XMLTV Guide: Supplies programme events, descriptions and schedule times for channels identified in the guide file.
- Xtream Login: Lets a compatible player request organised account, stream, library and EPG data from one server.
- EPG URL: Points directly to guide data and may be added manually when the playlist does not declare one.
- Player Database: Stores the downloaded channel and programme records until the next refresh or cache clear.
The important lesson is that a playlist and an EPG are complementary, not interchangeable. Importing an XMLTV address will not create playable channels, and importing an M3U file does not guarantee that schedules are included.
How IPTV Channels Are Matched to EPG Listings
Channel matching is the most important technical step. A guide may contain a channel ID such as news.ca.example. The matching M3U entry should carry the same value in its tvg-id attribute. When both values agree, the app knows which programme events belong beside that stream. Stable IDs also survive harmless changes to the visible channel name.
If the identifier is missing, some players fall back to tvg-name, the playlist channel name, or an XMLTV display name. Name matching is less reliable because punctuation, spaces and suffixes such as HD, East or West can differ. “News Toronto HD” may not match “News Toronto” without fuzzy matching or manual assignment.
With multiple playlists, assign each guide to the intended source, prefer exact IDs and disable overlapping guides. Refresh after changing a mapping so cached associations are rebuilt.
- Best Match: Playlist
tvg-idexactly equals the XMLTV channelid. - Fallback Match: Playlist and guide names agree closely enough for the player to associate them.
- Manual Assignment: The user selects an EPG channel when automatic matching fails.
- Duplicate Conflict: Multiple streams or guide sources compete for one visible channel name.
- Stale Mapping: A provider changes IDs while the player continues using previously cached associations.
When only a few channels show “No information,” inspect their identifiers before reinstalling the app. A partial failure usually points to mapping or missing listings, not a broken player.
Why EPG Times Are Wrong or Shifted
XMLTV programme times normally include a date, clock time and UTC offset. The player converts that timestamp using the device timezone. If the source omits or misstates the offset, the device clock is wrong, or daylight-saving rules are outdated, every programme can appear one or more hours early or late. A uniform shift across many channels is therefore a timing problem, not a channel-mapping problem.
Begin with automatic date, time and timezone settings on the television or streaming box. In Canada, select the correct regional zone rather than a generic fixed offset because daylight-saving behaviour differs by province and season. Refresh the guide after correcting the device. If the source is still consistently wrong, use the player’s EPG time-shift option only as a controlled correction.
Global Offset vs Channel-Specific Offset
A global offset moves the entire guide and is appropriate only when every affected channel is wrong by the same amount. A channel-specific offset is safer when one regional feed has been scheduled in another zone. Record the original value before changing it, and avoid stacking a playlist tvg-shift with an app-level shift unless both are genuinely required.
Use the current programme as a reference, then check at least one future listing after the change. A correct adjustment should align both entries. If the error varies through the day, the source data may contain inconsistent timestamps and needs correction by its publisher rather than another offset on your device.
| Symptom | Likely cause | Best first check |
|---|---|---|
| Every programme is one hour early | Timezone or daylight-saving conversion | Enable automatic time and reload the guide |
| Only one regional group is shifted | Source uses another broadcast zone | Apply a channel or source-specific offset |
| Times changed after travel | Device retained the previous timezone | Select the current region and restart |
| Grid is correct but catch-up opens wrong show | Catch-up correction differs from EPG time | Check archive offset separately |
| Future listings jump at a DST boundary | Outdated device or guide rules | Update software and obtain fresh data |
Do not use an offset to hide incorrect channel mapping. If titles belong to a completely different station, fix the assigned guide channel instead of moving its schedule.
Benefits and Limitations of an IPTV EPG
A reliable guide reduces channel surfing, supports search and helps viewers plan live television. An EPG is still only metadata: it cannot repair buffering, restore a dead stream or prove distribution rights.
| Area | What a good EPG can do | What it cannot guarantee |
|---|---|---|
| Navigation | Show current and upcoming programmes in a familiar grid | Make every listed channel playable |
| Discovery | Support title, category and description search | Add programmes missing from the source |
| Planning | Enable reminders and scheduled recordings in capable apps | Record without storage and DVR support |
| Catch-up | Identify the past programme and its time window | Create an archive that the provider does not supply |
| Personalisation | Power favourites, filters and genre views | Correct inconsistent channel metadata automatically |
| Stream quality | Help users choose the intended event or feed | Reduce buffering or increase resolution |
Judge an EPG by accuracy, coverage and refresh reliability. A polished grid with stale titles is less useful than a simple, correctly mapped guide.
How Often EPG Data Refreshes and Why Caching Matters
Guide sources publish a rolling window of current and future events. The player downloads it on a schedule and caches it locally, avoiding a server request whenever you move across the grid. The interval varies by app and provider. Rare updates leave stale listings, while a large download at every launch can slow an older television.
A healthy setup refreshes often enough to capture schedule changes without repeatedly rebuilding the entire database. Compressed XMLTV files reduce transfer size, and some players cache remote files on local storage. If the source changes channel IDs or corrects bad data, the local database may still display the previous version until a full refresh or cache clear.
- Scheduled Update: Let the app refresh automatically instead of manually updating the guide before every viewing session.
- Retention Window: Keep only the past and future days needed for catch-up, search and planning.
- Local Storage: Leave enough free space for channel artwork and programme records.
- Forced Refresh: Use it after a provider confirms new guide data or you change an EPG assignment.
- Cache Clear: Reserve this for stubborn stale or corrupt data because it requires the guide to rebuild.
If a fresh guide works briefly and then disappears, check storage, background restrictions and app permissions. The source may be valid even though the device cannot retain or update its local database.
What Determines EPG Accuracy and Coverage?
EPG quality depends on several independent factors: the accuracy of the original listings, how quickly last-minute changes are published, whether the guide covers the exact regional feed, and whether the playlist uses stable identifiers. Sports and breaking news are particularly difficult because events can overrun or move. Local affiliates may also carry different programmes from a national schedule. Test the channels you actually use instead of judging a guide by its total number of mapped stations.
| Quality factor | Good sign | Warning sign |
|---|---|---|
| Channel coverage | Current listings appear for important local and specialty channels | Large groups repeatedly show no information |
| Regional accuracy | East, West and local affiliate feeds have distinct schedules | One generic schedule is copied across every feed |
| Freshness | Late schedule changes appear after a normal refresh | Yesterday’s titles remain in current slots |
| Metadata depth | Titles, episodes and descriptions are consistently populated | Random fields or languages appear on neighbouring channels |
| Identifier stability | Favourites keep their guide after playlist updates | Mappings break whenever channels are renamed |
No source will be perfect on every channel. The practical goal is dependable coverage for the stations, time zones and languages your household watches, plus a support route when a large group stops updating.
How to Add an EPG URL to an IPTV Player
The menu names differ, but the workflow is similar in TiviMate, IPTV Smarters-type apps, Kodi IPTV Simple and Smart TV players. Obtain the EPG address from an authorised source. Never paste subscription credentials into public “EPG checker” websites. If an Xtream login already loads the guide, do not add the same source again.
- Open the Playlist Profile: Go to Settings, Playlists, Sources or TV Guide and select the account you want to edit.
- Choose the EPG Section: Look for EPG Sources, TV Guide, XMLTV or Programme Guide rather than the stream URL field.
- Enter the Exact Address: Paste the complete HTTP or HTTPS URL without spaces, missing characters or extra punctuation.
- Assign the Source: Link the guide to the correct playlist when the player supports multiple accounts or sources.
- Save and Refresh: Start an EPG update and allow a large file time to download and parse.
- Check Several Channels: Verify programme titles, regional feeds and current times instead of checking only one popular station.
- Correct Mapping Carefully: Manually assign unmatched channels or ask the provider to repair incorrect
tvg-idvalues.
Kodi IPTV Simple configures playlist and XMLTV sources separately, and changes may require clearing the PVR guide cache. Restart only after the refresh finishes.
Common EPG Problems and How to Fix Them
Troubleshoot from source to display: confirm the URL, confirm the download, refresh the cache, inspect channel matching and correct time settings. Changing several variables at once makes the result harder to interpret. A guide that fails on every device usually points to the source or account; a guide that fails on one player points to that profile, cache or application.
- Guide Is Completely Blank: Recheck the EPG URL, subscription status and network access, then force one update.
- Only Some Channels Are Blank: Compare
tvg-idvalues or use manual channel assignment instead of reinstalling the player. - Listings Are Outdated: Confirm the source has new data, shorten the refresh interval and clear stale cache once.
- Programmes Use Wrong Times: Fix the device timezone before applying a global or channel-level EPG offset.
- Update Fails on One Device: Free storage, remove battery restrictions, update the app and retry on a stable connection.
- Duplicate Guide Entries Appear: Remove the extra EPG source or duplicate playlist assignment and rebuild the guide.
- Catch-Up Opens the Wrong Show: Check the separate archive correction because EPG time and catch-up time may use different offsets.
If channels also freeze, crash or refuse to load, the problem is broader than EPG. Follow the site’s IPTV not working guide to test the connection, app, device and service separately before returning to guide mapping.
How to Choose a Reliable EPG Source

Use the guide supplied by a licensed television or IPTV service when it accurately covers your lineup. If you add a separate XMLTV source, check who maintains it, which regions it covers, how often it updates and whether its terms permit your use. Avoid unknown files that request account credentials, browser extensions or software installation merely to reveal a guide URL. Guide metadata deserves the same security care as a playlist because private URLs can identify or unlock an account.
- Relevant Coverage: Confirm the source includes your exact Canadian region, language package and time-zone feeds.
- Stable Channel IDs: Consistent identifiers reduce broken mappings after playlist names or logos change.
- Regular Updates: Future schedules should extend reliably and react reasonably to broadcaster changes.
- Clear Terms: The publisher should explain access, permitted use, privacy and any subscription renewal.
- Compatible Format: Choose XMLTV or the documented guide method supported by your maintained IPTV player.
- Responsive Support: Report missing groups with channel names, IDs, region and timestamps rather than sharing credentials.
The login method can affect how easily guide data loads. The site’s Xtream Codes explanation shows how structured account logins can deliver live categories and EPG responses alongside streams. Regardless of format, test accuracy before paying for a long plan.
Conclusion
EPG is the schedule layer that makes IPTV channels practical to browse. It connects playlist channels to programme metadata through identifiers, guide files and caching. When it fails, check the URL, mapping, refresh state and timezone. Accurate listings improve discovery, reminders, recording and catch-up navigation, but remain separate from stream quality and licensing.
FAQs
Is EPG included with every IPTV subscription?
No. Some subscriptions automatically load a guide through their account login, some supply a separate XMLTV URL, and others provide incomplete or no listings. Ask which channels and regions are covered, then test the guide during a short trial before buying a longer plan.
What is an XMLTV EPG URL?
It is a web address that returns television listings in the XMLTV format. The file normally contains channel identifiers plus programme start times, end times, titles and optional descriptions. An IPTV player downloads the file and matches those records to channels in the playlist.
Why does my EPG say “No information” while the channel plays?
The stream and guide are separate. The EPG source may lack that channel, the guide URL may be stale, or the playlist tvg-id may not match the XMLTV channel ID. Refresh the guide, inspect the mapping and manually assign the correct guide channel when supported.
Can I use one EPG source with several playlists?
Yes, if the source covers those channels and your player supports multiple playlist-to-guide assignments. Exact channel identifiers still need to match. Avoid attaching several overlapping guides to the same playlist because duplicate or conflicting events can appear in the grid.
Is EPG the same as catch-up TV?
No. EPG supplies programme metadata and time boundaries. Catch-up TV supplies archived video streams for past programmes. A player may use the EPG to launch an archive, but selecting an old guide item works only when the provider offers compatible catch-up data and playback URLs.
