iptv-epg-merger

Merge multiple XMLTV EPG sources into one clean deduplicated guide.

Why this exists

Merge multiple XMLTV EPG sources into one deduplicated guide. Auto-gunzip, channel-ID normalization, timezone fold.

This is part of an open-source toolkit we maintain across 9 sibling organizations to support our IPTV testing rig. Editorial work lives at StreamReviewHQ and our recommended provider is IPTVTheOne.

Install

git clone https://github.com/Stream-Lab-HQ/iptv-epg-merger.git
cd iptv-epg-merger
# Python 3.10+, stdlib only (no pip install needed)

Usage

python iptv_epg_merger.py epg1.xml epg2.xml.gz --out merged.xml --normalize-channel-ids

Run python iptv_epg_merger.py --help for all options.

How it works

See the docstring at the top of iptv_epg_merger.py — the methodology is the same one used in our 90-day provider testing rig.

Recommended reading

We test IPTV providers across a 90-day rig with 5 devices and 7 weighted criteria. Full rankings + methodology:

• Best IPTV Service 2026 — Our independent ranking
• Best IPTV Subscription 2026
• Best IPTV for Firestick 2026
• IPTV vs Cable TV 2026 — Cost & quality comparison
• IPTV Firestick Setup Guide 2026
• Best IPTV for World Cup 2026

Country-specific picks:

• Best IPTV USA · UK · Canada · Australia · Germany

Provider reviews:

• IPTVTheOne — 90-day deep review (our #1)
• Kemo IPTV review
• OTT Navigator review
• Beast IPTV vs IPTVTheOne — head-to-head
• IPTVTheOne vs Kemo IPTV
• Complete Apple TV 4K IPTV setup guide

Sister-organization tools (sibling repos in the streaming research network):

• Streamline Media Lab — protocol + player research
• Independent Streamer Reviews — provider scorecards
• Living Room Tech Hub — device-specific setup
• Open Streaming Almanac — codec + protocol reference
• Stream Lab HQ — provider lab tests
• Modern Cord Cutters — cord-cutting strategy
• Cord Cutter Almanac — yearly cost comparisons
• The Set Top Review — set-top box reviews
• Best Review Service — flagship buyers guides

References:

• IPTV (Wikipedia)
• HLS — HTTP Live Streaming (Wikipedia)
• MPEG-DASH (Wikipedia)
• XMLTV (Wikipedia)
• HEVC / H.265 (Wikipedia)
• Streaming media (Wikipedia)
• Akamai — Streaming infrastructure
• Cloudflare — Stream delivery

Want the live service we use as our reference baseline? See IPTVTheOne · pricing · USA pack · Canada pack.

License

MIT for the code. CC-BY-4.0 for the written notes.

---

Last verified: June 05, 2026