How iptv-org/iptv works
IPTV is both a public collection of channel playlists and a TypeScript command-line toolkit for maintaining and presenting that collection. The user-facing result is a generated M3U playlist that viewers can open in a video player; the README also documents alternate playlists and links to a separate EPG utility. Internally, the scripts load channel metadata, model streams and playlists, and provide validation, generation, and README-table commands. Relationships below follow the sampled code, SOURCE INDEX references, and README; unsampled command internals are not assumed.
Main entry points: api.ts Data API · stream.ts Stream model · playlist Playlist commands · validate.ts Issue validation
Components 20
Playlist workflow
- Public playlists
- Maintenance commands
scripts/commands - Playlist commands
scripts/commands/playlist - Playlist generators
scripts/generators
Channel data
- Data API
scripts/api.ts - Channel data files
scripts/constants.ts - Stream model
scripts/models/stream.ts
Validation and reports
- Stream tester
scripts/core/streamTester.ts - Proxy parser
scripts/core/proxyParser.ts - Issue validation
scripts/commands/issue/validate.ts - Discussion validation
scripts/commands/discussion/validate.ts - Report creation
scripts/commands/report/create.ts
Playlist presentation
- Playlist model
scripts/models/playlist.ts - Playlist parser
scripts/core/playlistParser.ts - README update
scripts/commands/readme/update.ts - Markdown tables
scripts/tables - Country table
scripts/tables/countriesTable.ts
Other components
- Video player user
- EPG utilities
- IPTV database
Connections 18
- Video player user → Public playlists: opens
- Data API → Channel data files: loads data
scripts/api.ts - Stream model → Data API: reads metadata
scripts/models/stream.ts - Playlist model → Stream model: formats streams
scripts/models/playlist.ts - Playlist parser → Stream model: creates streams
scripts/core/playlistParser.ts - Stream tester → Proxy parser: parses proxy
scripts/core/streamTester.ts - Issue validation → Data API: loads data
scripts/commands/issue/validate.ts - Issue validation → Stream tester: uses core
scripts/commands/issue/validate.ts - Discussion validation → Data API: loads data
scripts/commands/discussion/validate.ts - Report creation → Data API: loads data
scripts/commands/report/create.ts - Playlist commands → Data API: loads data
scripts/commands/playlist/update.ts - Playlist commands → Stream model: uses model
scripts/commands/playlist/update.ts - README update → Data API: loads data
scripts/commands/readme/update.ts - README update → Markdown tables: uses tables
scripts/commands/readme/update.ts - Country table → Data API: reads metadata
scripts/tables/countriesTable.ts - Country table → Public playlists: lists playlist links
scripts/tables/countriesTable.ts - IPTV database → Data API: provides channel data
- Public playlists → EPG utilities: EPG download