Repo brief: iptv-org/iptv

Generated by RepoPilot · document generated 2026-09-18 · concise human review Evidence snapshot · analyzed 2026-09-18T19:43:45.124Z · commit 48cc00e50b4a

Verdict

Healthy — Healthy across all four use cases

• Last commit 1d ago
• 16 active contributors
• Unlicense licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

iptv-org/iptv is a curated collection of publicly available IPTV (Internet Protocol Television) channel streams organized by country code into M3U playlist files. The repository aggregates and validates hundreds of live TV stream URLs from around the world, making them consumable by standard media players (VLC, Kodi, etc.) via M3U playlists. It serves as a free, community-maintained alternative to commercial IPTV service aggregators. Flat, data-driven structure: country-specific M3U playlist files in /streams/ directory (e.g., streams/ad.m3u, streams/br.m3u), TypeScript/JavaScript automation scripts in /scripts/ for validation and generation, and core tooling configuration…

Start here

Read these in order:

• scripts/constants.ts — Foundation: doesn't import anything internally and is imported by 29 other files. Read first to learn the vocabulary.
• scripts/generators/generator.ts — Foundation: imported by 12, no internal dependencies of its own.
• scripts/api.ts — Built on the foundation; imported by 16 downstream files.
• scripts/commands/api/load.ts — Layer 2 — application-level code that wires the lower layers together.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

Clone the repository, install dependencies with npm, and run validation:

git clone https://github.com/iptv-org/iptv.git
cd iptv
npm install

The postinstall hook will automatically run npm run api:load to fetch data. Verify the setup by running npm run playlist:validate or npm run playlist:lint to check playlist integrity.

Daily commands:

To validate existing playlists:

npm run playlist:validate
npm run playlist:lint

To generate or update playlists from the database:

npm run playlist:update
npm run playlist:generate

To run the full test suite:

npm test

…shortened for this brief.

Key cautions & unknowns

• Concentrated ownership — top contributor handles 50% of recent commits
• The postinstall hook runs npm run api:load immediately after npm install, which fetches data from an external API. This can fail silently or cause install delays if the iptv-org/api service is unavailable. The…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.