iptv-sources is a tool that automatically aggregates and updates IPTV channel sources and electronic program guide data from multiple upstream repositories and services.
The tool solves the problem of maintaining current IPTV stream listings by pulling from numerous community-maintained sources including iptv.org, fanmingming/live, and several other GitHub repositories, as well as dedicated EPG services. It combines these sources into unified M3U playlists and EPG data that can be consumed by media players and TV box applications. The approach works by periodically fetching and merging channel information from all configured upstream sources, handling GitHub raw content proxying, and providing rollback URLs when sources become unavailable.
The tool suits anyone running a personal IPTV setup who wants to maintain a current channel list without manually tracking multiple sources. It supports deployment through GitHub Pages, Docker, or Node.js, making it accessible whether you prefer a static hosting approach or a continuously running service. The README documents how to disable GitHub raw content proxying, configure custom proxy URLs, use the iptv-checker feature for stream validation, add rollback URLs, and create custom source configurations based on the upstream data.
The project maintains active discussion channels for user questions and deployment guidance. Development activity shows ongoing refinement of deployment options and feature documentation through community discussions addressing specific use cases like GitHub Pages hosting, Docker containerization, and Node.js deployment.
