# iptv-org/epg

Utilities for downloading the EPG (Electronic Program Guide) for thousands of TV channels from hundreds of sources.

Repository: https://github.com/iptv-org/epg
Canonical: https://ross.abutalabs.com/products/epg
Homepage: https://iptv-org.github.io/
Language: HTML
License: Unlicense
License Family: permissive
Topics: epg, tv, iptv, guide, xml
Last push: 2026-08-25T00:50:59+00:00

## Health v2 (maintenance only)
Score: 77/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 35, longevity 100
- inputs: {"age_days": 1999, "days_push": 9, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3250, forks 506 (observed 2026-08-28T04:07:51.974148+00:00)

## What it is
A Node.js tool that downloads Electronic Program Guide (EPG) data for thousands of TV channels from hundreds of sources and outputs it as XMLTV (guide.xml) or JSON. It supports configurable scraping of multiple sites with options for proxies, concurrency, timeouts, and gzip compression.

## Use cases
- download tv program guide for iptv channels
- generate xmltv epg file from multiple sites
- scrape tv schedules for thousands of channels
- create epg data for iptv playlist
- fetch program listings in json or xml
- aggregate tv guides from hundreds of sources

## When to choose
- you need EPG/XMLTV data for IPTV players or channel lineups
- you want to grab guides from many supported sites in one run
- you need proxy, concurrency, and language filtering options

## When to avoid
- you need a real-time streaming TV service rather than schedule data
- your source site is not among the supported sites
- you need a GUI-based EPG editor

## Facets
- artifact type: cli-tool
- maturity: active
- function: web-scraping, parser, data-generation, cli
- domain: media, developer-tools
- platform: cli, cross-platform
- tags: epg, iptv, xmltv, tv-guide, program-guide, automation, nodejs, docker

## Member repositories
- iptv-org/epg (main) score 77

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:51.974148+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:24:25.860342+00:00, confidence not recorded.
  - readme: https://github.com/iptv-org/epg (fetched 2026-08-28T04:07:51.974148+00:00, sha 8c5678e4d217)
  - homepage: https://iptv-org.github.io/ (fetched 2026-08-29T09:36:56.974555+00:00, sha 119ac8da9e3d)
- Data as of 2026-08-30T08:39:29.467469+00:00.