All data is stored in the /data folder as CSV (Comma-separated values) files. Any of the files can be edited either with a basic text editor or through any spreadsheet editor (such as Google Sheets, LibreOffice, ...).
| Field | Description | Required | Example |
|---|---|---|---|
| id | Unique channel ID. Should be derived from the name of the channel and country code separated by dot. May only contain Latin letters, numbers and dot. | Required | KSTSDT3.us |
| name | Official channel name. May include: a-z, à-ÿ, 0-9, space, -, !, :, &, ., +, ', /, », #, %, °, $, @, ?, (, ). |
Required | KSTS-DT3 |
| network | Name of the network operating the channel. | Optional | NBC |
| country | Country code from which the channel is transmitted. A list of all supported countries and their codes can be found in data/countries.csv | Required | US |
| subdivision | Code of the subdivision (e.g., provinces or states) from which the broadcast is transmitted. A list of all supported subdivisions and their codes can be found in data/subdivisions.csv | Optional | US-CA |
| city | Name of the city from which the channel is transmitted. May only contain a-z, à-ÿ, 0-9, space, -, '. |
Optional | San Francisco |
| broadcast_area | List of codes describing the broadcasting area of the channel. Any combination of r/<region_code>, c/<country_code>, s/<subdivision_code> |
Required | s/US-CA |
| languages | List of languages in which the channel is broadcast separated by ;. A list of all supported languages and their codes can be found in data/languages.csv |
Optional | eng;spa |
| categories | List of categories to which this channel belongs separated by ;. A list of all supported categories can be found in data/categories.csv |
Optional | news;weather |
| is_nsfw | Indicates whether the channel broadcasts adult content (TRUE or FALSE) |
Required | FALSE |
| logo | Logo URL | Optional | https://example.com/nbc.png |
| Field | Description | Required | Example |
|---|---|---|---|
| id | Category ID. Should be the same as the name but in lower case. | Required | news |
| name | Category name in one word. | Required | News |
| Field | Description | Required | Example |
|---|---|---|---|
| name | Official language name | Required | Croatian |
| code | ISO 639-3 code of the language | Required | hrv |
| Field | Description | Required | Example |
|---|---|---|---|
| name | Official name of the country | Required | Martinique |
| code | ISO 3166-1 alpha-2 code of the country | Required | MQ |
| lang | Official language in the country. | Required | fra |
| flag | Country flag emoji | Required | 🇲🇶 |
| Field | Description | Required | Example |
|---|---|---|---|
| country | Country code of the division. | Required | CA |
| name | Official subdivision name | Required | British Columbia |
| code | ISO 3166-2 code of the subdivision | Required | CA-BC |
| Field | Description | Required | Example |
|---|---|---|---|
| name | Official name of the region. | Required | Central Asia |
| code | Abbreviated designation for the region. May only contain Latin letters in upper case. The minimum length is 3 letters. | Required | CAS |
| countries | List of country codes in the region. | Required | KG;KZ;TJ;TM;UZ |
List of channels blocked at the request of copyright holders.
| Field | Description | Required | Example |
|---|---|---|---|
| channel | Channel ID | Required | AnimalPlanetAfrica.us |
| ref | Link to removal request or DMCA takedown notice | Required | https://example.com/issues/0000 |
If you find a bug or want to contribute to the code or documentation, you can help by submitting an issue or a pull request.
![@iptv-bot[bot]](https://avatars.githubusercontent.com/in/117246?s=64&v=4){kind=small}
