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…

  • Media Servers
  • Tools & Utilities
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 such as Plex and Jellyfin.

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

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

Collected 53 days ago - public community threads