IPTV EPG Setup: Fix a Missing or Wrong TV Guide

IPTV EPG is the programme guide that runs alongside the streams: what is on now, what starts next, and what is scheduled for the rest of the week. When it is empty or an hour out, the cause is usually one of four things, and all four are fixable in the player.

EPG stands for electronic programme guide. It is data, not video, and it travels separately from the stream. The stream tells the player what to play; the guide tells it what that stream is showing and when, which is what makes catch-up, reminders and recording possible.

XMLTV is the format nearly everyone uses for it. It is XML: a list of channels with identifiers, and a list of programmes with start times, durations, titles and descriptions. The provider publishes it at an address, the player downloads it on a schedule, and matches each programme to a channel by identifier.

That matching step explains most guide problems. A programme entry is only useful if the player can connect it to a channel it knows about. When the identifiers disagree, the guide looks empty even though the file is full of data.

Why the guide is empty: the four usual causes

Work through these in order. Each has a different signature, and telling them apart saves a reinstall.

The guide address is wrong or missing

The player has no source to download from, so the grid stays blank from the first minute. This is the usual state after adding an M3U playlist, because an M3U playlist carries no schedule. Open the playlist’s EPG settings and add the XMLTV address your provider issued, then point the playlist at it.

The time offset is wrong

The guide is not empty here; it is shifted. Everything starts an hour early or an hour late, consistently, on every channel. That is a timezone or daylight-saving problem rather than a missing feed, and the fix is an offset in the player rather than a new address.

The player has not refreshed

The guide shows a few hours and then stops, or it was fine yesterday and vanished today. Players download the feed on a schedule rather than continuously, and a box that was asleep during the refresh window can sit with stale data for a day. Force a manual refresh from the EPG settings.

The provider’s endpoint is behind or broken

Gaps appear across many channels at once, sometimes for all of them, and a refresh changes nothing. There is no local fix for this one. Refresh later, check whether the same gap appears in a second player, and report it, because the schedule is generated upstream.

A fifth case deserves its own line: the guide downloads but does not attach, because the channel identifiers do not match. That is a mapping problem, covered below, and it looks exactly like an empty guide.

Symptom, cause and first fix

Symptom	Likely cause	First thing to try
Guide blank since setup	No EPG address, or the wrong one	Add the XMLTV link in the playlist’s EPG settings
Blank since a playlist change	Assignment lost when the entry was rebuilt	Reassign the guide to the playlist
Every programme exactly one hour out	Timezone or daylight saving	Check the device clock, then the EPG offset
Half the channels right, half wrong	Bad schedule in the provider feed	Nothing local; note the channels and report them
Guide stops after a few hours	Feed truncated or refresh incomplete	Manual refresh and wait for the parse to finish
Guide fine yesterday, empty today	Refresh failed while the device slept	Manual refresh, then check the schedule
Programmes listed, no logos	Missing or dead logo tags	Cosmetic, ignore it
One channel has no guide at all	Identifier not mapped	Assign the guide channel manually

Two rows in that table are worth memorising. A uniform shift is a clock problem. A scattered mismatch is a feed problem. Almost every other guide symptom is one of the two wearing a different hat.

Fixing a one-hour or half-hour offset

If the guide is consistently shifted, the data is fine. Either the feed is published in a timezone the player has not been told about, or the offset has been applied twice.

1. Check the device clock first, including the timezone and the daylight-saving setting. A box set to the wrong city shifts the whole guide by the difference between the two cities.
2. Open the EPG settings for the playlist and find the time offset. Move it in half-hour or one-hour steps, then refresh the guide.
3. Test against a programme with a fixed start, such as a national news bulletin or a live match, rather than a film that may have been rescheduled.
4. If the guide is still out after adjustments in both directions, look for a second offset in the device’s own settings. Two corrections add up, and the result is a guide that is two hours wrong while both settings look reasonable.

Daylight saving is the recurring version of this problem. Twice a year, some feeds and some devices disagree for a day or two, and a guide that was right in March is an hour out in April. If the shift lasts a day and then corrects itself, that is what happened and there is nothing to fix.

Rule of thumb: if every programme is out by the same amount, the data is fine and a clock is wrong. If the gap changes from channel to channel, the feed is wrong.

A half-hour shift points at a specific set of timezones rather than daylight saving, which moves the clock by a full hour. If a half-hour correction fixes one group of channels and breaks another, the playlist is mixing feeds from two timezones and the honest fix is a second playlist for the second group.

Mapping channels by hand

When the guide has data but not for the channel in front of you, the identifier in the playlist and the identifier in the guide disagree. Large providers get this right most of the time; smaller ones and hand-edited playlists drift.

Most players let you assign a guide channel to a playlist channel. In TiviMate and IPTV Smarters the option sits with the channel or in the guide area rather than in the general settings, and the exact wording changes between versions, so look next to the channel rather than hunting a global menu. Once assigned, the schedule for that channel appears on the next refresh.

Fix the channels you watch rather than the whole list. A hundred manual assignments is an afternoon; five is ten minutes and covers most evenings. If a whole country group is affected, it is worth reporting rather than repairing, because a group-wide mismatch is generated upstream.

Names are a useful diagnostic. If the channel is called “Sky Sports Main Event HD” in the playlist and “SkySpMESD” in the guide, a name-based match will fail even though the identifiers might have worked. Some players fall back to matching on the display name when tvg-id is missing, which is why renaming a channel sometimes brings the guide back.

How much EPG data is normal

A healthy guide runs five to seven days ahead. iptvfine publishes a 7-day guide with channel logos, which is close to the ceiling most XMLTV feeds aim for; longer windows exist but are usually padded with repeats and placeholders rather than real scheduling.

• Under 24 hours: assume a refresh or truncation problem before assuming the provider has no data.
• Two to three days: usually a feed limit or a player setting that caps how much is downloaded.
• Five to seven days: normal.
• Beyond two weeks: rare, and worth treating with suspicion rather than satisfaction.

Size matters on small devices. A week of listings for a large playlist is a substantial file, and on a 1 GB streaming stick the parse is the slow part rather than the download. That is why a guide can look empty for several minutes after a refresh on cheap hardware while the same refresh takes seconds on a phone.

If the guide covers channels you never watch, the download is doing work you do not need. Most players let you limit the guide to favourites or to selected groups, which shortens both the download and the parse.

Keeping the guide accurate

Set the refresh to once a day, preferably overnight when the device is on but nobody is watching. More frequent refreshes add little: schedules are published in advance, and a box re-downloading every hour spends its processor on nothing.

• Refresh manually after any playlist edit, password change or restore from backup.
• Check one known channel after a refresh rather than assuming the whole grid is right.
• Before recording anything, confirm the guide is not shifted, or the recording will start at the wrong time.
• When daylight saving changes, check the offset once rather than changing it twice later.

If the guide disappears after a password change, the EPG address is the likely cause: many panels embed the account in the XMLTV link, so a new password means a new address. The TiviMate setup guide and the IPTV Smarters setup guide both cover where that address is entered in each app.

What goes wrong most often

These are the mistakes that produce a support ticket when the guide is briefly fine and then is not.

• Adding the XMLTV address in the playlist field instead of the EPG field, so the player tries to play the guide as a stream.
• Correcting the offset in the player while the device timezone is still wrong, which doubles the correction.
• Judging the guide in the first five minutes of a first download, before the parse has finished.
• Assuming a channel has no guide when its identifier is simply unmapped.
• Setting an hourly refresh on a low-RAM stick and then complaining that the interface stutters.
• Recording from a guide you already know is out of step, which produces a file of the wrong programme.
• Blaming the subscription for a gap that appears in one player only, which makes it a player problem.

Work from the outside in: address, then refresh, then offset, then mapping. The FAQ covers the account questions, and the channels page explains what the lineup includes if you are still deciding.

Frequently asked questions

Where to go next

• TiviMate setup: playlist, EPG and recording
• Fixing IPTV buffering
• M3U playlists and Xtream Codes
• Supported devices