EPG / XMLTV Guide Checker — Test Your IPTV Guide

Vivo IPTV does not host or own any media content or TV channels. Read disclaimer

Home Features Channels Pricing Services Blog Tools Get Started
Free Tool

EPG / XMLTV Guide Checker

Find out why your TV guide is empty: read any XMLTV file and see exactly which channels have programme data, and which do not.

A TV guide grid with some channels filled in and others left blank
Filled and empty rows, side by side in one guide · Illustration

An empty TV guide is one of the most common IPTV complaints, and almost always it is the EPG source rather than the player. This checker reads an XMLTV file and tells you what is actually inside it: how many channels it covers, how many have real programme data, and which ones are missing — so you stop guessing why the guide is blank.

Why the Guide Looks Empty

Your player does not invent programme times. It matches the tvg-id in your playlist against the id in an XMLTV guide file. If the two do not match, the channel shows nothing, no matter how good the guide is. There are only a few ways this goes wrong:

  • Wrong EPG URL — the guide link points at a different provider's file.
  • Mismatched IDs — the playlist says bbc1.uk and the guide calls it BBC1.
  • Sparse coverage — the guide covers the big channels and ignores the rest.
  • Stale data — the guide exists but stopped updating, so the times are days old.

This checker reads the guide and reports coverage so you can see which of those you are dealing with. The M3U parser reports the other half — how many channels in your playlist even have an ID to match.

Check Your EPG

Paste the content of your XMLTV file, or paste a URL and let the tool try to fetch it. Many hosts block browser access, so pasting the text is the reliable route.

EPG / XMLTV Guide Checker

Reads an XMLTV guide and reports channel coverage, programme counts and gaps. Runs in your browser.

What the Numbers Mean

The checker reports four things worth understanding. Channels listed is how many entries the guide defines. Channels with data is how many of those actually have programmes — a guide can define a hundred channels and fill ten. Coverage is the percentage of listed channels with real data; below about 70% and most users will see gaps. Programmes is the raw count, and it tells you whether the guide is fresh or thin.

Two mismatches are the usual culprits. Channels defined but never used mean the guide is bloated, which slows loading. Programmes attached to channels the guide never defined mean the file is malformed — usually two sources merged badly. Fixing either means going back to the provider for a clean EPG URL.

Getting a Better Guide

If coverage is poor, the fix is almost never in the player. Ask your provider for the correct XMLTV URL and make sure the tvg-id values in their playlist match the guide — the mismatch is theirs to fix, but you can confirm it with these two tools before you complain. Some users combine a provider guide with a free community one; the EPG and XMLTV guide URLs page covers how to wire a second source in.

Pasting beats fetching. Providers usually block a web page from downloading the guide, but the same URL works fine when your player fetches it. If the Fetch button fails, open the URL in a new tab, copy the text, and paste it above.
Why is my IPTV guide empty even though I added an EPG URL?
Usually a mismatch: the tvg-id in your playlist does not match the channel id in the guide, so nothing lines up. This checker shows how many channels the guide actually covers, and the M3U parser shows how many of your channels have an ID to match against.
What is a good EPG coverage percentage?
Aim for 70% or higher. Below that, most viewers notice missing schedules on the channels they use. The number matters less than whether the channels you actually watch are covered.
Why does the Fetch button fail but the URL works in my player?
Most EPG hosts block requests that come from a web page, to stop scraping. Your player fetches the same URL directly and works fine. Open the URL in a new tab, copy the XML, and paste it into the box instead.
What does it mean when programmes point at channels the guide never defines?
It usually means two guide files were merged badly, or the guide is out of sync with its own channel list. The fix is a clean EPG URL from your provider rather than editing the file by hand.
Does a bigger EPG file mean a better guide?
No. A guide that defines hundreds of channels and fills a fraction of them just loads slowly. Coverage per channel matters more than raw size.

Related Guides

See What a Stable IPTV Service Looks Like

30,000+ live channels, 50,000+ movies and series, 4K UHD — with free setup help whenever you need it.

View IPTV Plans

Get the setup guides first

One email a week with honest device reviews, buffering fixes and the best-value plans. No spam, unsubscribe in one click.

We use your email only to send this newsletter. See our Privacy Policy.