EPG Lab Docs

EPG LAB · USER GUIDE

Understand your guide.
Improve your coverage.

EPG Lab is a browser-based toolkit for validating XMLTV, matching M3U channels, exploring programme data and checking timezone information without uploading your playlist to our server.

Start using EPG Lab
01 · GETTING STARTED

Load two local files

For the richest results, load both an XMLTV file and an M3U playlist. XMLTV supplies guide channels and programmes; M3U supplies the stream names, URLs and metadata used for matching. You can load either file first.

1Choose XMLTVSelect an .xml, .xmltv or GZIP-compressed .gz XMLTV file.
2Choose M3UUse a playlist containing tvg-id or tvg-name where possible.
3Review resultsCheck the matcher, coverage, explorer and timezone preview.
GZIP-compressed .gz XMLTV files are decompressed locally in the browser. The tool does not support .tar.gz archives, and EPG Lab does not send files to a server for decompression.
02 · MATCHING

How channel matching works

EPG Lab uses a conservative hierarchy. Strong matches are preferred, while weaker results are shown for review rather than silently treated as exact.

MethodConfidenceMeaning
Exact ID100%M3U tvg-id equals the XMLTV channel ID.
Normalized ID / Name95%Harmless punctuation, spacing or case differences are normalized.
Alias / token90%Conservative token similarity, such as a channel name with an HD suffix.
Fuzzy70–89%Possible match that should be reviewed before relying on it.
No match0%No sufficiently reliable EPG channel was found.

Matched exports apply only accepted high-confidence mappings (90% or above) that are not flagged for review. Always review alias and fuzzy results before relying on them.

03 · COVERAGE

Read the coverage dashboard

Coverage is calculated as matched M3U entries divided by the total number of parsed M3U entries. Duplicate entries are not silently removed, so the denominator reflects the playlist you loaded.

Coveragematched entries ÷ total M3U entries × 100

The dashboard separates Exact, Normalized, Fuzzy and No Match counts so you can see not only how many channels matched, but how trustworthy those matches are.

04 · EXPLORER

Explore your guide data

EPG Explorer lets you inspect channel IDs, logos, programme counts, first and last programme times, categories and languages. Use Load more channels to progressively render large XMLTV files without creating thousands of DOM nodes at once. Search and filtering still operate over the complete parsed dataset.

05 · TIMEZONE

Preview timezone behavior safely

The Timezone tab is explicitly a Preview. It reads the source offset when it is present and formats a sample programme using the browser's native date and internationalization APIs. It does not rewrite the original in memory. Use Export converted XMLTV when you explicitly want a separate converted copy.

If you need permanent XMLTV timezone conversion, keep the original file as a backup and use a dedicated conversion workflow after reviewing the preview. The current EPG Lab keeps conversion separate and non-destructive: it exports a new XMLTV copy only after explicit confirmation.
06 · PERFORMANCE

Working with very large EPG files

For large files, keep only one working tab open, use an uncompressed UTF-8 XMLTV file, and allow the browser a moment to parse before switching tabs. EPG Lab indexes channel IDs and normalized names for matching, uses progressive Explorer rendering, limits visible result rows, and avoids server uploads or proxy requests. Closing other memory-heavy browser tabs can help with very large guides.

For extremely large XMLTV datasets, splitting the guide by provider or date before upload can improve responsiveness while preserving the same analysis workflow.

07 · PRIVACY & LIMITS

What stays local

Your XMLTV and M3U files are processed in the visitor's browser and are not uploaded to our server. EPG Lab does not create a server-side stream proxy. External icons or stream URLs may still be requested by the browser if the loaded data references them; browser security and CORS policies can affect those requests.

HTTP reachability, where applicable, is not the same as verified media playback. A CORS or browser-blocked result does not prove that a stream is offline.

08 · FAQ

Frequently asked questions

Does EPG Lab upload my files?

No. The files are read and processed locally in the browser.

Why did a channel receive a fuzzy match?

The M3U name resembles an XMLTV channel but does not meet the stronger ID or normalized-name rules. Review the confidence and method before exporting.

Can I use a GZIP XMLTV file?

Yes. EPG Lab can read a GZIP-compressed .gz XMLTV file directly in the browser. .tar.gz archives are not supported.

Does Timezone Preview change my XMLTV file?

No. It is non-destructive and does not rewrite the original; use Export converted XMLTV to create a separate converted copy.

Where can I convert M3U to EPG?

Use the M3U → EPG Converter on this website.

Scroll to Top