EPG: how the schedule works.
The live TV grid you see in TiviMate or Smarters is EPG data. Without it, you have a list of channels and no idea what is on. It is separate from the stream and loads separately.
- Format
- XMLTV
- Update interval
- 12-24h
- Channel match
- By ID
- Load time
- 1-5 min
Open XML standard
Typical provider cadence
Playlist must match EPG
On first sync
01
What is an EPG?
An Electronic Program Guide is the schedule data that sits behind the TV guide grid. On traditional cable, it comes baked into the signal. On IPTV, it is a separate data file your player downloads and renders.
Without EPG, your player shows a list of channel names. With it, you see a scrollable grid showing what is on each channel now, next, and for the next 7-14 days. Most players also let you filter by genre or set reminders.
The EPG data is not the stream. Disabling or losing EPG does not affect playback. It only affects the program guide display and any catch-up (replay) features tied to the schedule.
02
XMLTV format.
XMLTV is the standard format for IPTV guide data. It is a plain XML file where each program is a <programme> element with a start time, stop time, channel reference, title, and optional description.
Your player downloads this file, parses it, and builds an internal index keyed by channel ID and time range. When you open the guide, it looks up “what programs overlap with now on channel X?” in that index.
Channel matching is where it breaks. The playlist assigns each channel an ID (usually in a tvg-id tag). The XMLTV file uses the same ID on its channel element. If those two IDs do not match, the player cannot link the schedule to the channel.
03
Provider EPG vs XMLTV.
Most IPTV providers host their own EPG URL. It is typically auto-matched because the channel IDs in the provider playlist are designed to match that specific EPG file. This is the easiest path: use the EPG URL your provider gives you.
Third-party XMLTV sources exist (EPG.Best, WebGrab+, and others) for channels not covered by your provider's EPG. They scrape broadcaster schedule data independently. The tradeoff is that channel IDs may not match your playlist, requiring manual mapping in the player.
TiviMate Premium supports custom EPG sources and ID remapping. IPTV Smarters uses the EPG URL from the Xtream API automatically. Most players handle this under Settings → Playlists → EPG URL.
04
Fix missing or wrong listings.
Symptom
No schedule on any channel
Likely cause
EPG URL not set or not loaded
Fix
Go to Settings → Playlists (or EPG) in your player and add the EPG URL your provider gave you. Force a refresh.
Symptom
Schedule shows but times are off by hours
Likely cause
Timezone mismatch
Fix
Check the timezone setting in your player. Set it to match your local timezone. The EPG source may be in UTC; your player converts it.
Symptom
Schedule loads for some channels, not others
Likely cause
Channel ID mismatch or provider does not supply those channels
Fix
Your player matches EPG data by channel ID. If the playlist channel ID does not match the EPG ID, no data shows. Contact provider support or try a third-party EPG source.
Symptom
Schedule stopped working after update
Likely cause
EPG URL expired or changed
Fix
Log in to your provider dashboard and copy the current EPG URL. Update it in the player settings.
Symptom
EPG loads but program descriptions are in a different language
Likely cause
EPG source is for a different region
Fix
Ask your provider for a region-specific EPG URL or use an XMLTV source for your country.
For more general buffering and playback fixes, see the IPTV troubleshooting guide.
05
Player EPG settings.
In TiviMate, EPG is configured per-playlist. Go to Settings → Playlists → select your playlist → EPG settings. Paste the EPG URL, set the refresh interval, and tap Force update now after any URL change.
In IPTV Smarters Pro, EPG loads automatically from the Xtream API. If it shows empty, tap the refresh icon next to the guide tab. If it still fails, the provider's EPG may need an hour to populate on a fresh account.
On most players: allow 5 minutes for the first EPG load. A full 7-day guide for 5,000 channels is a large file. Do not interrupt it by closing the app.
The TiviMate setup guide has a dedicated EPG configuration section with the exact menu path.
06
FAQ
What is an EPG in IPTV?
An Electronic Program Guide is the schedule grid that shows what is on each channel. In IPTV, it is a data file (usually XMLTV format) that your player downloads and overlays on top of the channel list. Without it, you see channels but no schedule.
Why is my EPG empty or showing wrong times?
Three main causes: the EPG URL has not been set in your player, the EPG data has not finished loading (give it a few minutes on first sync), or the EPG source uses a different timezone than your device. Check the EPG URL in your player settings and force a manual refresh.
What is XMLTV?
XMLTV is an open XML-based format for TV schedule data. Each program entry has a start time, stop time, channel ID, title, description, and optional metadata. IPTV players download an XMLTV file and match channels to schedule data using a shared channel ID.
How often does EPG data update?
Provider EPGs typically update every 12-24 hours. XMLTV files from third-party scrapers can update more or less frequently. TiviMate lets you set a manual update interval; 24 hours is usually enough for a guide that looks correct tomorrow.
Why do some channels have EPG and others do not?
The EPG data source may not have listings for every channel. This is common with international or niche channels. Some IPTV providers only populate EPG for their most popular channels. The channel still works; you just will not see a schedule grid for it.
Start watching on Gloam
47,000+ live channels, plans from $13.99/mo. Cancel anytime from your account.
Last reviewed 2026-07-09. Prices and laws change; check the cited sources before you decide.