How iptv-org/database works
This repository is a user-editable IPTV reference database, with CSV files as its source of truth. Contributors propose channel, feed, logo, city, and blocklist changes through GitHub issues; issue validation checks requests against loaded database data, and the update command processes approved issues and saves changes. A separate validation/export path supports database quality checks and API data generation. The README documents API availability, but the API service itself is maintained elsewhere. Some command implementations were not sampled, so their internal wiring is represented only where supported by the tree, README, or excerpts.
Main entry points: db.ts Database access · update.ts Issue processing · models Domain records · validate.ts Request validation
Components 16
Contribution intake
- Issue forms
.github/ISSUE_TEMPLATE - Request validation
scripts/commands/issue/validate.ts
Database runtime
- Request fields
scripts/core/dataSet.ts - Database access
scripts/core/db.ts - Domain records
scripts/models - Validation rules
scripts/core/validator.ts - CSV source data
data
Data curation
- Issue processing
scripts/commands/db/update.ts - Database validation
scripts/commands/db/validate.ts - Logo checking
scripts/commands/db/check_logos.ts
Data distribution
- API data export
scripts/commands/db/export.ts - API data files
Other components
- Contributors
- GitHub issues
- API consumers
- Logo image hosts
Connections 19
- Contributors → Issue forms: submit changes
- Issue forms → GitHub issues: opens issue
- GitHub issues → Request validation: validates request
- Request validation → Request fields: parses fields
- Request validation → Database access: loads data
- Issue processing → GitHub issues: loads issues
- Issue processing → Database access: loads and saves
- Issue processing → Request fields: reads fields
- Issue processing → Domain records: updates records
- Database access → CSV source data: reads and writes
- Database access → Domain records: parses records
- Domain records → Validation rules: validates records
- Database validation → Database access: loads data
- Database validation → Domain records: validates records
- API data export → Database access: loads data
- API data export → API data files: exports data
- API consumers → API data files: accesses data
- Logo checking → CSV source data: reads logos
- Logo checking → Logo image hosts: checks images