FFLIPBOX

Setup guide · EPG

When the guide goes blank — and every other EPG fault

Guide data is separate plumbing from your channels: it travels as an XMLTV file, joins your playlist by ID tags, and fails in its own distinctive ways. Match your symptom below and apply its fix — and when in doubt, the free EPG checker reads any XMLTV source and reports what's actually inside it.

ALSO IN: DEUTSCH · PORTUGUÊS (BR)

Sixty seconds of theory that saves an hour of poking

Three pieces have to line up for a guide to render:

  • The playlist lists your channels, each ideally tagged with a tvg-id.
  • The XMLTV file — the EPG — lists channels by id and programmes with start/stop timestamps. With an Xtream login it arrives automatically from a standard endpoint; with an M3U playlist you attach its URL yourself.
  • The join: a channel shows programme data only when its tvg-id matches a channel id in the XMLTV file, and that channel actually has programmes with sane timestamps.

Every EPG fault is a failure of one of the three: no file, a bad file, or a broken join. The symptoms tell you which.

Symptom: the guide is completely empty

  1. Confirm a source is attached

    M3U playlists carry no programme data of their own. If you added a bare M3U URL and nothing else, there is no guide to show — edit the playlist and add the EPG/XMLTV URL from your provider's welcome message (it usually ends in .xml or .xml.gz). Xtream connections fetch the guide automatically.

  2. Test the source itself

    Paste the EPG URL into the EPG checker. It reports channel count, programme count, and date range in seconds. Zero programmes, or dates entirely in the past, means the provider's feed is broken at the source — no player can render data that isn't there. That's a support ticket to your provider, and now you can attach evidence.

  3. Refresh once, then wait once

    Guide files are large and regenerate on the provider's schedule. After attaching a good source, refresh the playlist; if the provider's file is mid-regeneration, give it an hour before concluding anything.

Symptom: some channels have data, others show nothing

That's the join failing channel-by-channel. The channels showing nothing carry a tvg-id that matches no channel in the XMLTV file — or carry none at all. It's a mapping gap in the provider's playlist, and it's common: big lists are assembled quickly, and the tags rot.

  • Run the EPG checker and compare its channel list against your expectations — it flags declared channels with zero programmes, one of the two halves of a broken join.
  • Ask your provider to fix the tvg-id tags for the channels you care about; point at specific ones. (If you maintain your own playlist file, correct the tags yourself — here's what each tag does.)
  • Duplicate variants sometimes map unevenly — the HD entry tagged, the 4K entry not. Flipbox's cleanup groups variants under one channel, which papers over exactly this unevenness.

Symptom: everything is shifted by the same few hours

A uniform shift is a timezone fault in the XMLTV file. Timestamps in the format 20261007203000 +0000 carry their offset with them; when a provider generates the file with the wrong offset — or strips offsets entirely and lets every player guess — the whole grid lands early or late by a constant amount.

  • Confirm your iPhone's own clock and timezone are set automatically (Settings → General → Date & Time). A phone pinned to the wrong zone shifts every app's schedule, not just the guide's.
  • Run the source through the EPG checker — it flags missing offsets and suspicious timestamp patterns explicitly, which turns “my guide is three hours off” into a report your provider can act on.
  • If the provider's file is wrong at the source, the durable fix is theirs to make. Grid times are data, not opinion.

Symptom: the guide ends a few hours out

Two honest possibilities, one of them ours:

  • The feed is shallow. Some providers publish only a few hours ahead. The checker shows the file's true forward depth — if the data stops, so must every player.
  • You're on Flipbox's free tier. Free shows a 3-hour guide window by design; Pro extends the timeline grid and guide search to 24 hours. If the checker shows a deep feed but your grid stops at three hours, that's the tier, not a fault — and the free window never shrinks.

Symptom: listings are from yesterday

  • Stale data means the provider's generator stopped — the checker's date-range readout makes it obvious (latest programme already in the past).
  • Refresh the playlist once to rule out a cached copy, then report it. Feeds that die on Fridays and revive on Mondays are a known species.
  • If your provider offers an alternative EPG endpoint (some list several), swap it in and re-test.
The ten-second habit

Before blaming any player — Flipbox included — run the EPG source through the checker. It answers the only question that matters first: is the data there at all? Everything downstream is rendering; rendering can't invent programmes.

Questions that come up

Why is my IPTV guide completely empty?

With an M3U playlist, the usual reason is that no EPG source is attached — programme data travels separately from the channel list, as an XMLTV file. Add the EPG URL from your provider. With an Xtream login the guide arrives automatically, so an empty guide there usually means the provider's feed itself is empty or stale.

Why are my guide times shifted by a few hours?

The XMLTV file's timestamps carry timezone offsets. When a provider generates them with the wrong offset — or omits offsets entirely — every programme lands shifted by the same amount. The data is wrong at the source; the EPG checker will show whether the offsets are present and plausible.

Why do some channels have guide data and others none?

Guide data joins channels by the tvg-id tag in your playlist. Channels whose tvg-id doesn't match any channel id in the XMLTV file show empty — a mapping gap in the provider's playlist, not a player fault.

Why does my guide stop three hours from now?

Two possible reasons: the provider's feed may only publish a few hours ahead, or you are on Flipbox's free tier, which shows three hours of guide by design. Check the feed's real depth with the EPG checker; if the feed goes deeper, Pro extends the visible grid to 24 hours.

My provider gave me no EPG URL. Is that normal?

With Xtream logins, yes — the guide comes with the connection automatically. With bare M3U links it means asking your provider for their XMLTV URL; most have one even when the welcome message forgets it.

The file ends in .xml.gz — is that a problem?

No. Compressed XMLTV is standard for big guides, and Flipbox handles it. The EPG checker can read gzipped sources too in modern browsers.

How often does Flipbox refresh the guide?

On its own schedule and whenever you pull to refresh — no setting required. If fresh data exists at the source, a manual refresh fetches it now.

Can Flipbox show a guide for channels with no data at the source?

No, and neither can anything else. A player renders what the XMLTV provides. The fix for missing data is always upstream — the practical move is identifying which half is broken, which is what the checker and this page are for.

Keep going