How to Set Up EPG and the TV Guide in IPTVX
What a programme guide actually needs, why half of it is often empty, and how to fix the half you can control.
BlogLive television without a programme guide is a list of channel names and a lot of guessing. The guide is what turns a playlist into something you can actually plan an evening around.
The catch is that EPG data is not something the player can invent. It arrives from your source, and most guide problems are really source problems wearing a player costume. This guide separates the two.
What EPG actually is
EPG stands for Electronic Programme Guide. It is a schedule: for each channel, a list of programmes with start and end times, titles and often descriptions.
Three things have to line up before you see it:
- The source must publish guide data. Either embedded in your playlist, attached to your login, or at a separate guide address.
- Each channel must carry an identifier the guide data recognises. This is where partial guides come from: some channels match, some do not.
- The player must have fetched it. On a large list, the first fetch takes time.
Where the guide comes from in IPTVX
Two paths, depending on how you added your source:
| How you added the source | Where guide data comes from | What you do |
|---|---|---|
| Xtream Codes login | Requested from the server with your credentials | Nothing, if the provider supplies it |
| M3U playlist with a guide reference | The address referenced inside the playlist | Nothing, if the reference is valid |
| M3U playlist without one | Nowhere until you supply an address | Add a guide address if the app offers it |
Open the same playlist in a second app, or ask your provider whether guide data is included. If the listings are missing there too, the data is not being sent and no setting in IPTVX will conjure it.:::
Step by step: getting listings to appear
- 1Load the source and wait. Channels usually appear before programmes. Give a large list several minutes on first load.
- 2Check one well-known channel. If that has listings and others do not, the issue is per-channel matching rather than the guide as a whole.
- 3Add a guide address if your source provides one separately. Enter the address your provider gave you for EPG. Some providers issue it as a separate URL.
- 4Refresh the guide. Force a reload rather than re-adding the whole source, which duplicates categories.
- 5Recheck after a provider change. If your provider rotated a token, the guide reference in the playlist may be stale even though channels still play.
When the guide stays empty
Four causes, in the order worth checking:
- No guide data published. The source has channels but no schedule feed at all.
- Expired guide address. The channel list still works because it uses a different reference.
- Identifier mismatch. The playlist labels channels in a way the guide feed does not recognise.
- Time zone confusion. Listings that look hours out of place are usually a schedule published in a different zone rather than a playback issue.:::warning A guide is not a catch-up service
Being able to see that a programme aired is not the same as being able to play it again. Catch-up availability depends entirely on what your source offers, and the player can only present what exists.:::
Making the guide comfortable to use
Once data is flowing, the guide becomes the main way you navigate live TV, so shape it:
- Hide categories you never open. A guide with 60 groups is worse than one with eight.
- Favourite the channels you watch most, so the guide opens on what matters.
- Re-order if the app allows it. The first row should be the channels you actually use.
The organisation guide covers all three in detail.
Reading the guide like a schedule
A guide is not just a list with times attached; it answers three different questions, and knowing which one you are asking changes how you use it.
What is on now? The current column. Scan channels rather than times.
What starts soon? The next block to the right. This is how you decide whether to wait twenty minutes or find something else.
What is on later tonight? Scroll forward, or use the guide's day navigation where it exists.
A guide that answers only the first question is still useful, but the second is what makes live television feel planned rather than accidental.:::note Programme descriptions are not reviews Descriptions come from the provider's feed, so they vary in quality and are sometimes missing entirely. A blank description is a gap in the data, not a fault in the player.:::
When listings are wrong rather than missing
Missing data is straightforward: the source did not send it. Wrong data is more confusing, and it has three usual causes.
A published schedule in another time zone. Programmes appear shifted by whole hours, consistently. Nothing on your device causes this and nothing on your device fixes it.
Stale data. The source updates its guide once a day, so an evening schedule change never appears. The player is showing what it was given.
Mismatched channel identifiers. A channel's listings appear under the wrong name, usually a sibling channel from the same provider.
In all three cases the fix lives with the source. What you can do is verify: compare the same channel's listings in a second app on the same playlist. If both show the same thing, the data is what it is.
A five-minute guide audit
Once listings are flowing, check the result rather than assuming it:
- 1Open three channels you watch regularly and confirm each shows a current programme.
- 2Scroll two hours ahead and confirm the schedule does not go blank.
- 3Compare one listing against the channel's own published schedule if it has one.
- 4Note any channel that consistently lacks data; it is usually a handful, not all.
That audit takes minutes and tells you whether the remaining gaps are worth chasing.
How long the first fetch should take
Expect the first guide load to be the slowest, and expect it to scale with the size of your playlist.
A few hundred channels resolve quickly. Tens of thousands of entries, with logos and programme data, can take several minutes on a television. During that time live TV usually works while the guide fills in.
The mistake worth avoiding is interrupting the fetch — closing the app, backing out to the source list, or re-adding the source. Give it the time it needs once, and subsequent loads will be far quicker because the data is already there.
What good looks like
A working setup shows a schedule for most channels, current programme highlighted, and a guide that opens in under a second on Apple TV. If listings exist but the guide feels slow, the cause is usually list size — hiding categories fixes it faster than anything else.
If channels themselves are not loading, work through the playlist troubleshooting guide first, then come back to the guide.
See your own playlist with real listings: Download IPTVX on the App Store.
Frequently asked questions
Electronic Programme Guide: the schedule data that tells the player what is on each channel and when. Without it, live TV still plays but you see channel names instead of programmes.
Keep going with IPTVX
IPTVX Team
We build and support the IPTVX player for iPhone, iPad, Mac and Apple TV. This blog explains what you can do with it — never which playlist to buy.
