iptv-org/iptv
59.2
Adequate · 14 November 2026
3.7k
lines of production code
TypeScript
primary language
7
measurements over time
What this system is
Features
Automated report generation for stream and channel requests
A new script in scripts/commands/report creates a comprehensive report by analyzing GitHub issues and discussions. It validates 'streams:add', 'streams:edit', and 'streams:remove' requests against existing stream data and channel blocklists, and processes 'Channel Search' discussions to determine fulfillment status, outputting a structured report with statuses like pending, fulfilled, or invalid.
scripts/commands/report · high confidence
Introduce core CLI utilities and media stream testing capabilities
This change adds a new set of core scripts to the \scripts/core\ directory, introducing structured output formatting via \CliTable\ (console) and \HTMLTable\ (HTML), data handling with \DataSet\, and parsing utilities for logs, numbers, playlists, and proxies. It also introduces a \StreamTester\ class that validates media streams using \axios\ and \mediainfo.js\, supporting proxy configurations (including SOCKS) and configurable timeouts, while replacing the previous \ffprobe\ dependency with \mediainfo.js\ for media analysis.
scripts/core · high confidence
New API data loading script
A new script at scripts/commands/api/load.ts has been added to facilitate loading API data. This script serves as a command-line entry point that invokes the downloadData function from the api module, allowing users to trigger data downloads via the command line.
scripts/commands/api · high confidence
New README table generation scripts for categories, countries, languages, and regions
Added new TypeScript scripts in the \scripts/tables\ directory that generate summary tables for the project's README files. These scripts parse \generators.log\ to extract channel counts for categories, countries (including subdivisions and cities), languages, and regions, then write the formatted Markdown content to \\_categories.md\, \\_countries.md\, \\_languages.md\, and \\_regions.md\ respectively.
scripts/tables · high confidence
New interactive playlist management and maintenance commands
The playlist maintenance workflow now includes a suite of new CLI commands for editing, formatting, testing, and validating playlists. The new \edit\ command provides an interactive interface to resolve missing channel IDs by selecting from similar channels or typing custom IDs. The \format\ command normalizes URLs, removes duplicates, and automatically detects stream quality using mediainfo.js, with configurable parallelism, proxy, and timeout options. The \test\ command verifies stream availability with live progress updates and can automatically remove broken links via the \--fix\ flag, while also checking for internet connectivity before running. The \validate\ command checks for missing IDs, invalid URLs, duplicates, and blocklist violations. Additionally, \update\ and \generate\ commands handle issue-based stream modifications and index generation.
scripts/commands/playlist · high confidence
New model classes for streams, playlists, and discussions
The \scripts/models\ directory now includes new TypeScript classes (\Stream\, \Playlist\, \Discussion\, \Issue\) that structure how IPTV playlist data is processed and exported. The \Stream\ class extends the SDK's stream model to handle parsing of quality suffixes, 24/7 labels, and geo-blocking flags from playlist names, while the \Playlist\ class manages the collection of streams and generates the final M3U output with guide URLs. These models provide the core logic for validating stream URLs, updating metadata from issue data, and formatting the final playlist string.
scripts/models · high confidence
New script generators for categorized M3U playlists
Added a suite of TypeScript generators in the scripts/generators directory that produce organized M3U playlist files from stream data. These include index generators (index.m3u, index.category.m3u, index.country.m3u, index.language.m3u) and categorized playlists grouped by categories, cities, countries, languages, regions, and subdivisions, as well as raw and source-based groupings. Each generator filters streams (e.g., SFW-only where applicable), groups them by the relevant attribute, and saves the resulting playlists to the public directory while logging output details.
scripts/generators · high confidence
New script infrastructure for data management and search
The scripts directory now includes a new api.ts module that handles downloading, loading, and searching IPTV data (channels, feeds, categories, etc.) using the @iptv-org/sdk, alongside new constants.ts and utils.ts files that provide path resolution, URL normalization, and stream info parsing utilities.
scripts · high confidence
New script to generate README documentation from API data
A new script (scripts/commands/readme/update.ts) has been added to automate the generation of the project's README documentation. This script fetches data from the API and updates the PLAYLISTS.md file by compiling it from a template, while also generating tables for categories, languages, countries, and regions. The script relies on the newly installed @freearhey/core package for logging functionality.
scripts/commands/readme · high confidence
Behavioural changes
2 commits (1 fix) modifying scripts/commands/discussion
A change to existing behaviour in scripts/commands/discussion — 2 commits (1 fix), 1 file: “Create validate.ts”; “fix: link the exact stream in discussion:validate fulfilled comments”.
scripts/commands/discussion · medium confidence · unverified
Automated playlist and documentation updates
The repository's curated IPTV playlists and associated documentation (README, PLAYLISTS, FAQ) are automatically refreshed daily by a bot to reflect changes in channel availability, add new country-specific playlists, remove dead links, and update channel counts. This ensures the provided M3U lists remain current and that user guides accurately reflect the available content.
(repo-wide) · high confidence
New validation script for issue-based stream operations
A new \validate.ts\ script has been added to the \scripts/commands/issue\ directory to validate GitHub issue submissions for stream management. This tool checks the markdown body of issues labeled \streams:add\, \streams:remove\, or \streams:edit\ against the current database state. It verifies that stream URLs are valid URIs with correct domains, ensures requested stream IDs correspond to existing channels and feeds, and prevents duplicate additions or removals of non-existent streams. It also flags channels blocked for DMCA or NSFW reasons. The script exits with an error log if validation fails, ensuring data integrity before any changes are processed.
scripts/commands/issue · high confidence
Updated global IPTV stream playlists
The M3U playlist files in the streams directory have been updated with new, replaced, and removed live TV stream URLs across all country-specific and service-specific files (e.g., us.m3u, uk.m3u, jp.m3u). This includes adding new channels, fixing broken links, and removing dead or non-working streams to ensure the available channels remain functional.
streams · high confidence
Test coverage
2 commits adding/updating tests in tests; 2 commits adding/updating tests in tests/\_\data\\_/input/discussion\validate; 2 commits adding/updating tests in tests/commands/discussion; 4 commits adding/updating tests in tests/\\data\\_/expected/playlist\update; 6 commits adding/updating tests in tests/\\data\\_/expected/playlist\_update/streams; Added expected playlist test data for Afghanistan and Antigua & Barbuda; Added test coverage for playlist management commands; Added test fixture for nested playlist format; Added test fixture for playlist generation log output; Added test fixture for readme update generators; Added test fixtures for AT, IN, and NL playlist formats; Added test fixtures for BR, CY, UK, and US M3U playlists; Added test fixtures for GitHub issues, discussions, and offline DNS mocking; Added test fixtures for playlist export validation; Added test fixtures for playlist parsing with error scenarios; Added test fixtures for playlist update scenarios; Added test fixtures for playlist validation edge cases; Added test for readme update command; Added test for report:create command; Added test input data for issue validation; Added test input data for playlist editing with CRLF line endings; Added test input for playlist path validation; Added tests for issue:validate command and updated readme/update tests; Test coverage for reserved URL escape preservation in playlist formatting; Test data: new M3U playlist inputs for Andorra, Canada, Indonesia, India, Kyrgyzstan, Qatar, UK, and unsorted streams; Updated expected playlist generation test fixtures.
Dependencies
Initialize project dependencies and tooling
The project now includes a defined set of dependencies and build scripts. Key additions include the \iptv-playlist-parser\ for handling playlist data, \m3u-linter\ for validation, and \mediainfo.js\ for media inspection. The tooling stack uses \eslint\ (v9) and \vitest\ for code quality and testing, while \axios\ is updated to v1.19.0. An override is configured to pin \esbuild\ to version 0.23.1.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 57 → 59 (+2.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 69 → 69 (+0.1)
- Architecture 72 → 72 (+0.3)
- Maturity 59 → 61 (+1.7)
- Readiness 51 → 56 (+5.7)
- Security 76 → 61 (-14.2)
- Performance 60 → 60 (+0.0)
Resolved (26)
- CountriesTable.create (cognitive 23) (scripts/tables/countriesTable.ts)
- CountriesTable.create (cyclomatic 18) (scripts/tables/countriesTable.ts)
- FunctionTooLong: create.main (scripts/commands/report/create.ts)
- FunctionTooLong: validate.main (scripts/commands/playlist/validate.ts)
- High secret: WD-SECRET-0005 (package-lock.json)
- High secret: WD-SECRET-0005 (package-lock.json)
- Hotspot: scripts/commands/issue/validate.ts (scripts/commands/issue/validate.ts)
- Leaked secret: hardcoded-credential (package-lock.json)
- Medium: security finding (details withheld)
- MethodTooLong: CountriesTable.create (scripts/tables/countriesTable.ts)
- Off-boarding risk: anonymized user #1
- Outdated (npm): glob
- Secret: generic-api-key (channels/unsorted.m3u)
- Stream.getBroadcastSubdivisions (cognitive 17) (scripts/models/stream.ts)
- StreamTester.test (cognitive 24) (scripts/core/streamTester.ts)
- TooManyMethods: Stream (scripts/models/stream.ts)
- create.main (cognitive 39) (scripts/commands/report/create.ts)
- create.main (cyclomatic 39) (scripts/commands/report/create.ts)
- update.addStream (cognitive 19) (scripts/commands/playlist/update.ts)
- update.addStream (cyclomatic 17) (scripts/commands/playlist/update.ts)
- …and 6 more
New (17)
- High CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: [GHSA redacted] (package-lock.json)
- Medium CVE: [GHSA redacted] (package-lock.json)
- Off-boarding risk: anonymized user #1
- Outdated (npm): @stylistic/eslint-plugin
- Outdated (npm): @typescript-eslint/eslint-plugin
- Outdated (npm): @typescript-eslint/parser
- Outdated (npm): axios
- Outdated (npm): glob (package.json)
- Outdated (npm): mpd-parser
- Outdated (npm): vitest
- Secret: generic-api-key (streams/bg.m3u)
- Secret: generic-api-key (streams/cn.m3u)
- Secret: generic-api-key (streams/cn.m3u)
- Secret: generic-api-key (streams/cn.m3u)
- Secret: generic-api-key (streams/cn.m3u)
- Secret: generic-api-key (streams/cn.m3u)
Changes since last survey
- 93 commits — 82 feature/other, 11 fixes
By area
- (repo) — 25 commits
- (root) — 20 commits
- streams/ar.m3u — 8 commits
- .github/ISSUE_TEMPLATE — 3 commits
- streams/us_klowdtv.m3u — 3 commits
- scripts/utils.ts — 2 commits
- streams/ae.m3u — 2 commits
- streams/gt.m3u — 2 commits
- streams/mk.m3u — 2 commits
- streams/my.m3u — 2 commits
- streams/us.m3u — 2 commits
- streams/vn.m3u — 2 commits
- .github/workflows — 1 commit
- docs/playlists.md — 1 commit
- scripts/commands — 1 commit
- streams/af.m3u — 1 commit
- streams/am.m3u — 1 commit
- streams/be.m3u — 1 commit
- streams/bg.m3u — 1 commit
- streams/bo.m3u — 1 commit
Notable commits
- fix: Merge pull request #56456 from Shubham-Padkonde/fix/decode-proxy-credentials
- fix: Merge pull request #57678 from Dev-next-gen/fix/discussion-validate-permalink
- fix: Merge pull request #57874 from Dev-next-gen/fix/update-test-swallowed-assertions
- fix: Merge pull request #57885 from p2xcode/fix/ca-rdi-url
- fix: Merge pull request #57889 from haziqfikri96/fix/malaysia-streams
- fix: Merge pull request #58637 from Dev-next-gen/fix/format-keep-encoded-query
- fix: Update my.m3u: remove dead Malaysia streams, fix RTM entries
- fix: fix: keep encoded query delimiters when playlist:format normalizes links
- fix: fix: link the exact stream in discussion:validate fulfilled comments
- fix: fix: sort query parameters without decoding their escapes
- fix: fix: update ICI RDI (ca) stream URL to 704026/canrdi
- change: ...
- change: Add Kanal 8 stream
- change: Merge branch 'master' into master
- change: Merge branch 'master' into patch-13
- change: Merge pull request #56560 from iptv-org/dependabot/github_actions/actions-minor-patch-2f4c4b3894
- change: Merge pull request #56681 from iptv-org/LP-102626
- change: Merge pull request #56898 from iptv-org/freearhey-patch-2
- change: Merge pull request #57062 from iptv-org/LP-102926
- change: Merge pull request #57195 from amirmazinany78/master
- …and 73 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
iptv-org/iptv was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 1a6af3e3dba738a0a9c76cf837297640c0e95b35 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.