Bbergle-zap2xml
Zap2Xml is an automated TV guide (EPG) generator that downloads your chosen Zap2it/Gracenote listings grid and converts it into XMLTV format for media servers…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
45/100 Fair
- Maintained
- 24last commit 485 days ago
- Popular
- 43135 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
- Security check
- 100no serious findings, CI, tests
Based on 4 of 5 factors.
Availability: platform listings confirmed today, links checked 30 days ago
- GitHub stars
- 135
- Open issues
- 18
- Last commit
- 2025-07-24
- Latest release
- v2.2.0
- License
- MIT
- Activity
- stale
Checked 9 days ago - source: GitHub (jef/zap2xml)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Create a Zap2it account first Before configuring zap2xml, create a free account at tvlistings.zap2it.com (now operated by Gracenote) and enter those credentials in the setup fields. source
- Output: XMLTV guide file zap2xml produces a standard XMLTV (xmltv.xml) guide file; point your media server's EPG settings at it to get TV listings. source
Fetched 39 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
How do I select the channel lineup and preferred content?
Set LINEUP_ID, COUNTRY, POSTAL_CODE, and PREF as environment variables. PREF can include m, p, or h to show music, pay-per-view, or HD content.
How many days of listings can zap2xml request?
TIMESPAN controls the window in hours and can be set up to 360 hours, which is 15 days. The default is 6 hours.
How do I keep the generated XMLTV file in Docker?
Set OUTPUT_FILE to a path inside the container and mount a host directory at that location. The example uses /xmltv/xmltv.xml with a host mount at /xmltv.
How can zap2xml run automatically on a schedule?
Docker can use SLEEP_TIME to wait before the next run, with a default of 21600 seconds. Native installs should use a task scheduler.
Why might older zap2xml scripts fail because of Zap2It?
A forum thread notes that zap2it moved to a gracenote domain. It also provides a sed command to update zap2xml.pl.
Answers sourced from forum.libreelec.tv, github.com
Community
- zap2xml for guide data : r/PleX - Reddit (reddit)
- zap2it: now located at https://tvlistings.gracenote.com/grid-affiliates ... (forum)
- zap2xml.exe and zap2it.com are dead. any free alternatives? (forum)
- Replacement for Zap2Xml? (forum)
- EPG No Longer Working - zap2xml - forums.nextpvr.com (forum)
Collected 53 days ago - public community threads