iptv-org/epg

EPG is a command-line utility for downloading Electronic Program Guide data for thousands of TV channels from hundreds of sources.

The tool solves the problem of aggregating TV schedule information from fragmented sources by providing a unified interface to fetch and consolidate EPG data into standard XML format. It works by allowing users to specify one or more supported sites, then downloading channel guides from those sources and optionally splitting the output by site or merging into a single file. The tool supports parallel downloading to speed up the process, customization through command-line options, and scheduled execution via cron expressions or task schedulers.

Developers maintaining IPTV applications, media center software, or TV guide services should consider this tool if they need to programmatically fetch EPG data from multiple providers. It suits projects that require regular guide updates and can work with custom channel lists defined in XML format. The tool can be run as a standalone command-line utility, deployed in Docker containers with automatic daily updates, or exposed via HTTP server for network access. Installation requires Node.js and Git, and the project maintains a list of supported sites in its documentation.

The project uses automated workflows to keep guide data current. Development activity shows consistent maintenance of the codebase and regular updates to the list of supported EPG sources. The tool is actively used in production environments and receives ongoing support for new source integrations and feature requests through its community channels.