[XMLTV Viewer](https://codoplayer.com/tools/xmltv-viewer)

# XMLTV Viewer and EPG File Merger

Open an XMLTV guide file (XML or gzip) from your device and see its channels, how many programmes each has, the gaps, a day schedule and a search. Merge two guides and export XMLTV, JSON or CSV. It runs in your browser and sends nothing to us.

## How it works

1. Choose a guide file (XML or .xml.gz); add a second one to merge.
2. Read the channel table with its gaps, search a title, or open one channel for one day.
3. Download the merged guide as XMLTV, JSON or CSV.

## What the results mean

The overview gives the number of channels and programmes and the period the guide covers. The table shows, per channel, its programmes, first start, last end, gaps and overlaps, all in UTC. Search finds a title across every channel, and the day view lists one channel for one day.

## Common problems

A channel with many gaps has an incomplete guide at its source. A programme list whose channel is "not declared" has programmes for an ID that no channel entry names, which is why a player may show no name for it. Times are in UTC here, so compare them with your player's time zone.

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

## Example input

Save this small XMLTV guide as a file and open it. Choose CSV to download the programme row.

```
<tv>
  <channel id="harbor.news"><display-name>Harbor News</display-name></channel>
  <programme channel="harbor.news" start="20261201180000 +0100" stop="20261201183000 +0100">
    <title>Harbor Report</title>
  </programme>
</tv>
```

**You get:** A report for one channel and one programme. The CSV shows the programme times in UTC.

## Example result

```
channel_id,channel_name,start_utc,stop_utc,title
"harbor.news","Harbor News","2026-12-01T17:00:00.000Z","2026-12-01T17:30:00.000Z","Harbor Report"
```

## Messages this tool can show

| Message | What it means | What to do |
| --- | --- | --- |
| That guide is over 80 MB of XML once unpacked, which is too large for the browser. | The file is bigger than the browser limit. | Split the guide, or check it from its address with the EPG Validator. |
| That file does not look like an XMLTV guide (no &lt;tv> or &lt;programme> found). | The file is not XMLTV. | Choose the guide file, not the playlist. |
| (not declared) | The guide has programmes for a channel ID that no channel entry names. | Ask the guide's source to add the channel entry, or ignore that ID. |
| Type the day as year-month-day. | The day for the schedule could not be read. | Type for example 2026-01-31. |

## Questions about the XMLTV Viewer

### How do I open an XMLTV or EPG file?

Choose the .xml or .xml.gz file from your device. The browser unpacks a gzip file itself and a background thread reads it, so the page stays usable. You then see every channel with its programme count, first start and last end, with all times shown in UTC.

### How does the viewer find gaps in a guide?

For each channel it sorts the programmes by start time. A hole of at least one minute between the end of one programme and the start of the next is a gap, and a programme that starts before the previous one ended is an overlap. The table counts both.

### How big can the guide file be?

A guide can hold up to 80 MB of XML once unpacked. A larger file gets a message that it is too large for the browser, and the page keeps working. Split a huge guide first, or check it from its address with the EPG Validator, which reads it on our server.

### Does this tool upload my guide file?

No. The file is read and merged in your browser, the search runs there, and the downloads are made on your device. Nothing is uploaded, stored or counted by the tool, and no address is fetched. The page itself is loaded from our server like any other page, and the site menu works as it does elsewhere.

## More playlist tools

- [EPG Validator](https://codoplayer.com/tools/epg-validator): Check an XMLTV guide: channels, days ahead, time zone, gaps and errors.
- [EPG Matcher](https://codoplayer.com/tools/epg-matcher): Match your channels to the TV guide and fix wrong or missing tvg-id.
- [EPG Time Shifter](https://codoplayer.com/tools/epg-shift): Move a whole guide, or some channels, by hours when the times are off.
- [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.
- [Playlist Converter](https://codoplayer.com/tools/converter): Xtream login ↔ M3U link, and M3U ↔ JSON, CSV, VLC, PLS, WPL, Enigma2 and Neutrino lists.

### Related

- [IPTV guide times wrong: fix a guide that is an hour off](https://codoplayer.com/guides/epg-times-wrong)
- [IPTV guide or catch-up unavailable](https://codoplayer.com/errors/guide)

Source: https://codoplayer.com/tools/xmltv-viewer
