An EPG in IPTV — short for Electronic Program Guide — is the on-screen TV guide that shows what's playing on every channel right now and what's coming up next: the grid of show titles, start times, and descriptions you scroll through instead of flipping channels blindly. If cable's channel guide is the only version you've seen, the IPTV version works differently under the hood — it's a data file your app downloads from your provider over the internet — and understanding that one fact solves about 90% of guide problems. If you're still getting oriented, our plain-English explainer on what IPTV is and how it delivers TV over the internet covers the foundation.
This guide covers the rest: what an EPG actually is, how the XMLTV format and EPG URL work in plain words, exact setup steps for IPTV Smarters Pro, TiViMate, and IBO Player Pro, and a troubleshooting table for the classic failures — empty guide, times off by a few hours, blank channels, stale listings.
What an EPG actually is
Open any IPTV player and press the guide button, and you'll see a grid: channels down the left, a timeline across the top, and program blocks filling the rows — "NFL on FOX, 1:00–4:25 PM," "Local News at 6," and so on. That grid is the EPG. Depending on the player and the data behind it, each entry can carry a title, start and stop time, a description, sometimes a category, an age rating, or artwork.
The EPG is what turns a raw channel list into something that feels like television. Without it, every channel is a mystery box — you tune in and hope. With it, you can see that the game starts in 40 minutes, set a reminder, check what's on the movie channels tonight, and — where your service supports catch-up — jump back to a show that already aired. More on that last part below.
One thing worth being clear about: the guide data and the video streams are separate things. Your channels come from your provider's streaming servers; your guide comes from a schedule file. Either one can work while the other doesn't. That's why a blank guide almost never means your subscription is broken — the channels usually play fine even when the grid is empty.
How an IPTV EPG works, in plain words
Under the hood, almost every IPTV guide is an XMLTV file. XMLTV is a long-standing open format: a structured text file that lists channels (each with an ID) and programs (each with a channel ID, a start timestamp, a stop timestamp, a title, and usually a description). Your provider generates this file continuously from schedule data and hosts it at a web address — the EPG URL.
Your player's job is simple in principle:
- Download the XMLTV file from the EPG URL (for a big channel lineup this file can run to tens of megabytes).
- Parse it — read every channel and program entry into a local database.
- Match each channel in your playlist to its entries in the guide file. This matching happens through channel IDs (in M3U playlists you'll see them as
tvg-idtags); when the IDs line up, the guide fills in. - Cache and refresh — the parsed guide is stored on your device and re-downloaded on a schedule (or when you force an update), because listings change daily.
If you log in with Xtream Codes credentials — a server URL, username, and password, which is how ZyroTV logins work — most players fetch the guide automatically, because the Xtream API tells the app where the EPG lives. If you load a bare M3U playlist instead, many players need the EPG URL entered separately in settings. That single difference explains a huge share of "my friend's guide works and mine doesn't" cases.
🔑 The one rule that prevents most EPG pain
Use the EPG URL your own provider gives you, not a random guide source from a forum. The guide only fills in when channel IDs in your playlist match channel IDs in the guide file — and only your provider's EPG is built against your provider's channel IDs. A third-party guide with mismatched IDs gives you blank rows or, worse, the wrong shows listed on the right channels.
How to add or fix the EPG in popular players
Below are the exact paths in the three players we get asked about most. Full setup walkthroughs for these and other apps live in our IPTV player setup hub.
IPTV Smarters Pro
- Log in with your Xtream Codes details (server URL, username, password). Smarters loads the EPG from the server automatically — you don't normally enter a separate URL.
- If the guide is empty: open the EPG section from the home screen, tap the refresh icon, and wait — a large guide can take a couple of minutes to download and parse the first time.
- Still empty? Go to Settings → EPG Settings, enable Auto EPG Update, and check the EPG Time Shift value if times look wrong (see the timezone fix below).
- As a last resort, log out and log back in — Smarters rebuilds its local guide database on a fresh login.
If you're new to the app itself, start with our full IPTV Smarters Pro guide — it covers login, layout, and every setting that matters.
TiViMate
- With an Xtream login, TiViMate pulls the EPG automatically. To check or add a source manually: Settings → EPG.
- Tap Add source and paste the EPG URL from your provider if one isn't already listed.
- Set Update interval to daily — more frequent re-downloads waste bandwidth for no benefit, since listings don't change hour to hour.
- Use Update EPG in the same menu to force an immediate refresh after any change.
- Times wrong? Long-press a channel → Manage channel → EPG time shift, or set it globally under Settings → EPG.
TiViMate's guide is the best-looking of the three once it's fed good data. Our walkthrough on how to log in to an IPTV server on TiViMate takes you from install to a working guide.
IBO Player Pro
- IBO Player Pro activates by device (it reads your device's MAC address, and you attach your playlist to it via the IBO website or in-app screen).
- When adding your playlist, fill both fields: the playlist/portal details and the EPG URL field — IBO doesn't always discover the guide on its own from a plain playlist.
- In the app, open Settings and look for the EPG or "Update EPG" option to force a first download.
- If the guide stays empty, re-check the EPG URL for typos on the IBO management page — a single wrong character fails silently.
💡 First load is the slow one
A guide covering tens of thousands of channels is a big file. The first download-and-parse can take one to three minutes on a Firestick and the app may look frozen. Give it time before you start changing settings — impatient re-taps mid-parse are how people corrupt a half-built guide database and end up worse off.
Common EPG problems and the actual fixes
Nearly every guide complaint we see in support comes down to one of six causes. Find your symptom, apply the fix:
| Symptom | Likely cause | Fix |
|---|---|---|
| Guide completely empty, channels play fine | EPG never downloaded — missing URL (M3U logins) or first fetch failed | Confirm the EPG URL in player settings, then force an update and wait for the full parse |
| Every program off by the same few hours | Timezone mismatch — XMLTV times are often in UTC and your player isn't offsetting | Set EPG time shift in the player (e.g., −4 or −5 for US Eastern depending on daylight saving) or fix the device's timezone setting |
| Most channels fine, some rows blank | No schedule data exists for those channels, or their IDs don't match the guide | Normal for niche/regional feeds — try another version of the same channel; report big-name channels to support |
| Guide shows yesterday's listings | Stale cache — auto-update off or interval too long | Force a manual EPG update, then set auto-update to daily |
| Guide worked, then vanished after an app update or crash | Corrupted local EPG database | Clear the app's cache/EPG data (or log out and in) so it rebuilds from a fresh download |
| Wrong shows listed on the right channel | Provider-side mapping error — channel pointed at the wrong guide ID | Nothing to fix on your end; report the channel to your provider so they remap it |
Two of these deserve a little more depth, because they're the ones people misdiagnose.
The timezone offset. XMLTV timestamps carry timezone information, but not every player interprets it correctly, and some guide feeds are generated in UTC. The telltale sign is that everything is shifted by exactly the same amount — 4, 5, or 8 hours. That's never a broken guide; it's arithmetic. Every serious player has an EPG time-shift setting; set it once and it stays fixed. Check your device's own date/time/timezone settings too — streaming boxes fresh out of the factory sometimes sit on the wrong region.
The stale guide. An EPG is a snapshot. If your player downloaded it Monday and never refreshed, by Thursday it's fiction. Set the update interval to daily and the problem never returns. And if your box is one you unplug nightly, remember the refresh can only happen while the app has a chance to run.
⚠️ Don't fix the guide by reinstalling everything
Deleting and reinstalling the whole app is the nuclear option people reach for first, and it usually just costs you your favorites and settings. Work up the ladder instead: force an EPG update → check the EPG URL → clear the app's EPG/cache data → then, only if all that fails, reinstall.
Why some channels have no guide data — an honest answer
No IPTV service on earth has 100% EPG coverage, whatever the sales page says. Guide data has to come from somewhere: broadcasters and schedule aggregators publish listings for major networks, but plenty of channels — small regional stations, international feeds, 24/7 single-show loop channels, event and PPV feeds — either publish no machine-readable schedule at all or publish one nobody aggregates. A 24/7 channel that plays one sitcom on repeat genuinely has no schedule to show.
So the realistic expectation for a healthy service: the big-name channels — networks, sports, news, movies — should have full, accurate listings, and coverage thins out as you get into the long tail. If a major channel is blank in your guide, that's worth reporting, because it's usually a fixable ID mapping issue on the provider's side. If an obscure feed is blank, that's just the nature of the data. This is the same "the number isn't the story" logic we apply to channel counts generally — coverage quality on the channels you actually watch beats totals.
EPG, catch-up, and timeshift: how they connect
The guide isn't just decoration — it's the skeleton that catch-up TV hangs on. Where a service records channels server-side, the player uses EPG entries as the index: yesterday's programs show in the grid, marked as playable, and selecting one plays the recording from the archive. No guide entry, no catch-up button — even if the recording technically exists on the server. The same goes for "watch from start" timeshift on a live program: the player needs the EPG's start time to know where "the start" is.
That's the practical reason to care about a well-mapped EPG beyond convenience: on channels where catch-up is available, guide quality directly decides whether you can use it. It's also why fixing a timezone offset matters more than it seems — catch-up on a guide that's five hours off will start playback in the wrong place. If you want the fuller picture of how the streams themselves reach your screen — servers, protocols, buffering — see our companion explainer on how IPTV works end to end.
The EPG you get with ZyroTV
ZyroTV includes an XMLTV EPG URL with every subscription, built against our own channel lineup — 30,000+ live channels across the US and Canada including locals — so IDs match and the guide fills in without manual mapping. Log in with your Xtream Codes credentials in IPTV Smarters Pro, TiViMate, IBO Player Pro, or any player you prefer, and the guide loads automatically; the M3U playlist route works too, with the EPG URL entered once in settings. You can check whether the channels you care about are covered in our full channel list, and if a guide row that matters to you is ever blank or mismapped, 24/7 WhatsApp support is the fast path to getting it fixed — mapping reports from users are genuinely useful to us.
Want a guide that just fills in? Every ZyroTV plan ships with Xtream login, M3U playlist, and a matched XMLTV EPG — from $15 for one month, with a 7-day money-back guarantee.
See ZyroTV plansBottom line
An EPG is the on-screen program guide, delivered in IPTV as an XMLTV file your player downloads from your provider's EPG URL, caches, and refreshes. Xtream logins usually wire it up automatically; M3U setups may need the URL pasted once. When it misbehaves, the failure is almost always local and boring — a missing URL, a stale cache, a timezone offset — and the table above fixes all of them in a few minutes. And when a channel has no data at all, that's usually the data ecosystem, not your setup: judge a service by guide accuracy on the channels you actually watch, not by whether every row in a 30,000-channel grid is filled.