What an EPG is
An Electronic Program Guide (EPG) is the on-screen schedule of what each channel is showing. In an IPTV player it usually appears as a grid with channels down the side and time across the top, or as “now and next” information when you browse channels. The guide doesn’t contain any video — it is schedule data that your player shows alongside the channels.
How guide data reaches your player
- The guide is published as a data file, commonly in the XMLTV format — an open XML format for TV listings (see the XMLTV project).
- Your player downloads that file from a guide link, either automatically or from a link you add.
- The player matches each guide entry to a channel in your list.
- It stores the schedule and refreshes it on a timetable, which you can usually change in the settings.
Large guides can take a few minutes to download the first time, especially on slower devices. A blank guide right after you sign in is often just still loading.
Setting up the guide
| Login type | How the guide loads | What to do |
|---|---|---|
| Xtream Codes | Usually automatically, with the channel list | Sign in, then wait for the guide to finish loading |
| M3U playlist | Only if the playlist names a guide link, or you add one | Add the guide (EPG/XMLTV) link in the playlist settings if you were given one |
| Device-linked players | Set up on the developer’s website | Add the guide link where the website asks for it |
A guide link looks like an ordinary web address. This example uses a reserved example domain and is not a working link: http://epg.example.com/guide.xml. Use only the details you were given, and keep them private. Our M3U vs Xtream Codes guide explains the two login types.
Channel matching
Each channel in a playlist carries an identifier that should match an entry in the guide file. In an M3U playlist it looks like this (example only):
#EXTINF:-1 tvg-id="news.example" group-title="News",Example News HD
If the tvg-id doesn’t match any guide entry, that channel shows “No information” even though the rest of the guide works. Some players let you match a channel to a guide entry by hand; others rely entirely on the identifiers. Ask WhatsApp Support if a channel you watch often has no guide data.
Wrong times and time zones
- Device time zone first. Players show guide times in the device’s time zone, so check the date, time and time zone in the device settings.
- Player offset second. Many players have an EPG offset or time-shift setting. Set it to zero unless your listings are consistently off by the same amount.
- East and West feeds. Some US channels have Eastern and Pacific versions that air three hours apart — make sure you’re watching the feed you expect.
- International channels may publish guide data in their own time zone; an offset may help for those channels only.
Catch-up TV
Catch-up (sometimes called replay, archive or time shift) lets you go back in the guide and play a program that has already aired. With IPTV USA, catch-up is available for up to 7 days on supported channels.
- Open the guide and move back to an earlier time on a channel that supports catch-up.
- Look for the replay or archive icon on the program.
- Select it to play from the beginning; pause and rewind usually work within the program.
Players that document catch-up include TiviMate, iPlayTV (with Xtream Codes logins), UHF Player and XCIPTV.
EPG vs catch-up vs VOD
| Feature | What it does | When you can watch |
|---|---|---|
| EPG (TV guide) | Shows the schedule of live channels | Not video — information only |
| Catch-up | Replays programs that already aired on a live channel | For a limited time — up to 7 days on supported channels |
| VOD (movies & series) | A separate on-demand library | Any time, while the title is in the library |
Player and device differences
- Grid guides are a strength of TV-first players such as TiviMate; touch players often show a simpler list.
- Guide refresh schedules and storage limits vary; low-storage devices may keep fewer days of guide data.
- Device-linked players (such as IBO Pro Player or Smart IPTV) manage guide links on the developer’s website.
- MAG boxes get the guide from the portal rather than from a guide link — see MAG box setup.
Compare players in IPTV player apps.
EPG troubleshooting steps
- Wait a few minutes after signing in — large guides take time.
- Refresh the guide (or the whole playlist) in the player’s settings.
- Check the guide link is added if you use an M3U playlist and were given one.
- Fix the time zone on the device, then reset the player’s EPG offset.
- Free up storage and restart the device if the guide stops updating.
- Update the player, then sign out and back in if nothing else works.
| What you see | Likely cause | Fix |
|---|---|---|
| Whole guide empty | Still loading or no guide link | Wait, refresh, add the guide link |
| Some channels say “No information” | Channel not matched to guide data | Ask support; match manually if your player allows |
| Times shifted by hours | Time zone or offset | Correct the device time zone; reset the offset |
| Guide stops after a day or two | Refresh schedule or storage | Refresh manually; free up storage |
| No catch-up icon | Channel or player doesn’t support catch-up | Try a supported channel or a player with catch-up |
Playback problems too? See the IPTV troubleshooting guide and the IPTV internet speed guide.
