[EPG Validator](https://codoplayer.com/tools/epg-validator)

# EPG Validator (XMLTV Guide Checker)

Reads a whole XMLTV guide and tells you how many channels and programmes it has, how many days ahead it goes, which time zone it uses, and what’s broken in it.

## How it works

1. Paste the guide link, choose a guide file, or use the guide named in your playlist.
2. The whole guide is read, even very large and gzip ones. A file you choose is read by your browser and is not uploaded.
3. See the coverage, the time zone and every problem found.

## What the results mean

The report shows how many channels and programmes the guide holds, how many days ahead it goes, which time zone it uses and every problem found, including gaps.

## Common problems

If the guide looks fine but times are off, your player's time-zone setting is the usual cause. Gaps and short coverage are problems at the guide's source.

Step-by-step guide: [IPTV guide shows "No information": fix tvg-id mismatches](https://codoplayer.com/guides/epg-no-information).

## Example input

A TV guide (XMLTV) link or file, with placeholder values (replace USER, PASS and example.tv with your own):

```
http://example.tv:8080/xmltv.php?username=USER&password=PASS
```

**You get:** Whether the guide reads, how many channels and programmes it holds, and the time range it covers.

## Example result

Produced by this tool's own code from a small invented example. Counts, the time range and each kind of problem with an example.

**Example input** (invented, example.com addresses):

```
<?xml version="1.0" encoding="UTF-8"?>
<tv generator-info-name="invented example">
  <channel id="news.one"><display-name>News One</display-name></channel>
  <channel id="sports.two"><display-name>Sports Two</display-name></channel>
  <channel id="kids.three"><display-name>Kids Three</display-name></channel>
  <programme start="20261201180000 +0000" stop="20261201190000 +0000" channel="news.one"><title>Evening News</title></programme>
  <programme start="20261201183000 +0000" stop="20261201193000 +0000" channel="news.one"><title>Weather</title></programme>
  <programme start="20261201190000 +0000" stop="20261201200000 +0000" channel="sports.two"><title>Match Highlights</title></programme>
  <programme start="20261201200000 +0000" stop="20261201195000 +0000" channel="sports.two"><title>Late Show</title></programme>
  <programme start="20261201180000 +0000" stop="20261201190000 +0000" channel="ghost.one"><title>Unlisted</title></programme>
  <programme start="20261201190000 +0000" stop="20261201200000 +0000" channel="news.one"></programme>
</tv>
```

**Result**

```
Channels: 3
Programmes: 6
Channels with no programmes: 1
Guide covers: 2026-12-01 18:00 to 2026-12-01 20:00 UTC
Time zone offsets seen: +0000
Problem unknown_channel: 1 (e.g. ghost.one)
Problem stop_before_start: 1 (e.g. sports.two 20261201200000 +0000)
Problem overlap: 2 (e.g. news.one 20261201183000 +0000; news.one 20261201190000 +0000)
Problem no_title: 1 (e.g. news.one 20261201190000 +0000)
Problem empty_channel: 1 (e.g. Kids Three)
```

## Messages this tool can show

| Message | What it means | What to do |
| --- | --- | --- |
| Paste the TV guide (XMLTV) link — your playlist doesn’t name one. | No guide link was given and the playlist has none. | Paste the guide link from your provider. |

## Questions about the EPG Validator

### My guide shows the wrong times — is it the guide?

Look at the time zone the guide uses. If it’s right but the times are still off, your player’s time-zone setting is the usual cause; the EPG Time Shifter can move the guide too.

## More playlist tools

- [EPG Matcher](https://codoplayer.com/tools/epg-matcher): Match your channels to the TV guide and fix wrong or missing tvg-id.
- [XMLTV Viewer](https://codoplayer.com/tools/xmltv-viewer): Open a local XMLTV file: channels, schedule, gaps, search, merge and export.
- [EPG Time Shifter](https://codoplayer.com/tools/epg-shift): Move a whole guide, or some channels, by hours when the times are off.
- [Catch-up Checker](https://codoplayer.com/tools/catchup): See which channels keep past programmes, and for how many days.
- [Playlist Checker](https://codoplayer.com/tools/checker): Is your line working? Account, expiry, channel counts and which channels answer.
- [Playlist Editor](https://codoplayer.com/tools/editor): Choose, rename and reorder groups and channels, then download your own playlist.

### Related

- [IPTV guide times wrong: fix a guide that is an hour off](https://codoplayer.com/guides/epg-times-wrong)
- [How to get the Xtream EPG URL and check an empty guide](https://codoplayer.com/guides/xtream-epg-url)

Source: https://codoplayer.com/tools/epg-validator
