Program Guide · 6 min read · Updated on 2026-11-17
What is EPG and how does the program guide work?
EPG (Electronic Program Guide) displays current and upcoming schedule blocks for live streams using XMLTV or Xtream metadata. Learn how matching works and why local IndexedDB caching matters.

What EPG (Electronic Program Guide) is and how XMLTV pairs with channels
An Electronic Program Guide (EPG) is the digital schedule overlay that shows what program is airing right now, when it started, how much time remains on the progress bar, and what airs next on a live channel. Without EPG metadata, a playlist only knows the static name and stream URL of each channel.
In the M3U and Xtream ecosystem, program schedules travel separately from video streams using two main mechanisms: compressed or uncompressed XMLTV documents (.xml or .xml.gz referenced via url-tvg or x-tvg-url in the #EXTM3U header) and Xtream Codes JSON endpoints (get_short_epg).
To link a schedule to the right broadcast, the player matches the channel identifier tag — specifically tvg-id="..." inside an M3U #EXTINF line or epg_channel_id inside Xtream JSON — against the <channel id="..."> and <programme channel="..."> nodes inside the EPG feed.
- Displays current show title, start/end timestamps, live progress percentage, and upcoming program.
- Supports both Xtream Codes short-EPG JSON responses and XMLTV guide structures.
- Automatically decodes Base64-encoded program titles and descriptions returned by Xtream panels.
Why Web Worker parsing and IndexedDB caching are essential for EPG
A single 48-hour XMLTV guide covering hundreds of channels can easily contain 80,000+ XML <programme> tags and exceed 25 to 50 megabytes once decompressed. Parsing that volume of XML synchronously on the browser main thread freezes scrolling, delays clicks, and crashes low-memory mobile tabs.
ZavoxPlayer solves this by offloading EPG parsing to a background Web Worker and caching normalized schedule records inside IndexedDB. Your TV grid opens immediately from cached catalog data while schedule timestamps update smoothly in the background without dropping a single animation frame.
Fixing shifted EPG hours and missing "No Program Information" slots
XMLTV timestamps include explicit UTC offsets such as 20261117210000 +0000 or -0300. ZavoxPlayer converts those timestamps automatically to your device timezone. If every channel schedule appears shifted by exactly 1, 3, or 5 hours, verify first that your Windows, macOS, Android, or iOS clock is set to Automatic Time Zone.
If only certain channels show no schedule while others work properly, the external playlist usually left tvg-id blank on those specific channels or the provider XMLTV generator has not published events for regional feeds. Because ZavoxPlayer is strictly a neutral media player, it displays the guide supplied by your source without injecting third-party channel lists.
Step-by-step instructions
- 01.
Connect via Xtream Codes or an M3U playlist containing url-tvg metadata
Xtream Codes connections configure short-EPG endpoints automatically; for M3U links, ensure your provider includes url-tvg or x-tvg-url in the playlist header.
- 02.
Keep your device clock and timezone set to Automatic
Enable automatic network time on your PC or phone so UTC program timestamps align accurately with your local hour.
- 03.
Open TV to view current/next shows and progress bars
Select any live category or open a live channel to see the active broadcast title, progress indicator, and upcoming schedule.
Guide FAQ
Does ZavoxPlayer provide its own built-in TV guide for third-party channels?
No. ZavoxPlayer is strictly a media player and reads the EPG metadata supplied by your own configured M3U or Xtream source.
Does loading EPG data slow down video startup?
No. Video playback takes priority while EPG parsing runs asynchronously inside a background Web Worker with IndexedDB caching.
Are EPG schedules uploaded to cloud storage?
No. Cached EPG schedules remain strictly local inside your device IndexedDB storage.
Ready to try ZavoxPlayer?
Open the zero-signup demo or sign in with your email for a 48h free trial.