From 7e13ea71657dabe97ec75dc71c3dab46a4460194 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Isma=C3=ABl=20Moret?= <30985701+BellezaEmporium@users.noreply.github.com> Date: Wed, 27 May 2026 12:00:38 +0200 Subject: [PATCH 1/4] Update CONTRIBUTING.md to improve clarity and structure --- CONTRIBUTING.md | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 307e8d59e2..117b11f19e 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -8,7 +8,7 @@ ## How to? -### How to add a new stream link to a playlists? +### How to add a new stream link to a playlist? You have several options: @@ -18,25 +18,25 @@ You have several options: Regardless of which option you choose, before posting your request please do the following: -- Make sure the link you want to add works stably. To check this, open it in one of the players (for example, [VLC player](https://www.videolan.org/vlc/index.html)) and watch the broadcast for at least a minute (some test streams are interrupted after 15-30 seconds). +- Make sure the link you want to add is stable, and works properly. To check this, open it in one of your usual players (for example, [VLC media player](https://www.videolan.org/vlc/index.html)) and watch the broadcast for at least a minute (some test streams are interrupted after 15-30 seconds). - Make sure the link is not already in the playlist. This can be done by [searching](https://github.com/search?q=repo%3Aiptv-org%2Fiptv+http%3A%2F%2Fexample.com&type=code) the repository. -- Make sure the link does not lead to the Xtream Codes server. [Why don't you accept links to Xtream Codes server?](FAQ.md#why-dont-you-accept-links-to-xtream-codes-server) +- Make sure the link does not lead to a Xtream Codes server. [Why don't you accept links to Xtream Codes servers?](FAQ.md#why-dont-you-accept-links-to-xtream-codes-server). If you're unsure, please check [How to distinguish a link to an Xtream Codes server from a regular one?](#how-to-distinguish-a-link-to-an-xtream-codes-server-from-a-regular-one) - Make sure that the link leads directly to the broadcast, without unnecessary redirects. -- Find the ID of the channel you want on [iptv-org.github.io](https://iptv-org.github.io/). If your desired channel is not on the list you can leave a request to add it [here](https://github.com/iptv-org/database/issues/new/choose). -- Make sure the channel is not blocklisted. It can also be done through [iptv-org.github.io](https://iptv-org.github.io/). +- Find the ID of the channel you want on [iptv-org.github.io](https://iptv-org.github.io/). If your desired channel is not on the list, you must add it via a request [here](https://github.com/iptv-org/database/issues/new/choose). +- Make sure the channel is not blacklisted. It can also be done through [iptv-org.github.io](https://iptv-org.github.io/). - If you know that the broadcast only works in certain countries or it is periodically interrupted, do not forget to indicate this in the request. -A requests without a valid stream ID or working link to the stream will be closed immediately. +A request without a valid stream ID or working link to the stream will be closed immediately. Note all links in playlists are sorted automatically by scripts so there is no need to sort them manually. For more info, see [Scripts](#scripts). ### How to fix the stream description? -Most of the stream description (channel name, feed name, categories, languages, broadcast area, logo) we load from the [iptv-org/database](https://github.com/iptv-org/database) using the stream ID. +Most of the stream description (channel name, feed name, categories, languages, broadcast area, logo) is loaded from [iptv-org/database](https://github.com/iptv-org/database) using the stream ID. -So first of all, make sure that the desired stream has the correct ID. A full list of all supported channels and their corresponding IDs can be found on [iptv-org.github.io](https://iptv-org.github.io/). To change the stream ID of any link in the playlist, just fill out this [form](https://github.com/iptv-org/iptv/issues/new?assignees=&labels=streams%3Aedit&projects=&template=2_streams_edit.yml&title=Edit%3A+). +First of all, make sure that the desired stream has the correct ID. A full list of all supported channels and their corresponding IDs can be found on [iptv-org.github.io](https://iptv-org.github.io/). To change the stream ID of any link in the playlist, just fill out this [form](https://github.com/iptv-org/iptv/issues/new?assignees=&labels=streams%3Aedit&projects=&template=2_streams_edit.yml&title=Edit%3A+). -If, however, you have found an error in the database itself, this is the place to go: [How to edit channel description?](https://github.com/iptv-org/database/blob/master/CONTRIBUTING.md#how-to-edit-channel-description) +If, however, you have found an error in the database itself, please refer to: [How to edit channel description?](https://github.com/iptv-org/database/blob/master/CONTRIBUTING.md#how-to-edit-channel-description) ### How to distinguish a link to an Xtream Codes server from a regular one? @@ -63,7 +63,7 @@ An issue without a valid link will be closed immediately. ### How to find a broken stream? -For starters, you can just try to open the playlist in [VLC player](https://www.videolan.org/vlc/). The player outputs all errors to the log (Tools -> Messages) so you'll be able to determine pretty accurately why a link isn't working. +For starters, you can just try to open the playlist in [VLC media player](https://www.videolan.org/vlc/). The player outputs all errors to the log (Tools -> Messages) so you'll be able to determine pretty accurately why a link isn't working. Another way to test links is to use the NPM script. To do this, first make sure you have [Node.js](https://nodejs.org/en) installed on your system. Then go to the `iptv` folder using [Console](https://en.wikipedia.org/wiki/Windows_Console) (or [Terminal]() if you have macOS) and run the command: @@ -150,7 +150,7 @@ http://example.com/stream.m3u8 - `preview.png`: image displayed in the `README.md`. - `template.md`: template for `PLAYLISTS.md`. - `scripts/`: contains all scripts used in the repository. -- `streams/`: contains all streams broken down by the country from which they are broadcast. +- `streams/`: contains all streams broken down by country from which they are broadcasted. - `tests/`: contains tests to check the scripts. - `CONTRIBUTING.md`: file you are currently reading. - `PLAYLISTS.md`: auto-updated list of available playlists. @@ -168,7 +168,7 @@ To run scripts use the `npm run ` command. - `act:format`: allows to test the [format](https://github.com/iptv-org/iptv/blob/master/.github/workflows/update.yml) workflow locally. Depends on [nektos/gh-act](https://github.com/nektos/gh-act). - `act:update`: allows to test the [update](https://github.com/iptv-org/iptv/blob/master/.github/workflows/update.yml) workflow locally. Depends on [nektos/gh-act](https://github.com/nektos/gh-act). - `api:load`: downloads the latest channel and stream data from the [iptv-org/api](https://github.com/iptv-org/api). -- `playlist:format`: formats internal playlists. The process includes [URL normalization](https://en.wikipedia.org/wiki/URI_normalization), duplicate removal, removing invalid id's and sorting links by channel name, quality, and label. +- `playlist:format`: formats internal playlists. The process includes [URL normalization](https://en.wikipedia.org/wiki/URI_normalization), duplicate removal, removing invalid ids and sorting links by channel name, quality, and label. - `playlist:update`: triggers an update of internal playlists. The process involves processing approved requests from issues. - `playlist:generate`: generates all public playlists. - `playlist:validate`: сhecks ids and links in internal playlists for errors. From 8812c594249096c820459976c549ece149dea2e3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Isma=C3=ABl=20Moret?= <30985701+BellezaEmporium@users.noreply.github.com> Date: Wed, 27 May 2026 12:04:56 +0200 Subject: [PATCH 2/4] Revise FAQ content for improved clarity Updated FAQ section for clarity and added details about the database of TV channels. --- FAQ.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/FAQ.md b/FAQ.md index 988fc265dc..2f50bcb213 100644 --- a/FAQ.md +++ b/FAQ.md @@ -12,12 +12,13 @@ No. ### Why is the channel on the iptv-org.github.io but not in the playlist? -The site contains a list of all TV channels in the world and only those of them for which we have working stream links are included in the playlists. +The site is an extensive database of all existing TV channels in the world, and does not represent a list of streams in our possession. Only those of them for which we have working stream links are included in the playlists. +You may still check [iptv-org.github.io](https://iptv-org.github.io) with the "feeds:>1" parameter in the search bar to check all available feeds. ### Can I add a radio broadcast? Yes, if it is a [visual radio](https://en.wikipedia.org/wiki/Visual_radio) in which a video and audio are shown at the same time. -### Why don't you accept links to Xtream Codes server? +### Why don't you accept links to Xtream Codes servers? Xtream Codes streams tend to be very unstable, and often links to them fail very quickly, so it's easier for us to initially exclude them from the playlist than to search for expired ones every day. From 4529e805c1823dd26d8663c48298f5c4d00642cf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Isma=C3=ABl=20Moret?= <30985701+BellezaEmporium@users.noreply.github.com> Date: Wed, 27 May 2026 12:05:27 +0200 Subject: [PATCH 3/4] Update CONTRIBUTING.md with new sections --- CONTRIBUTING.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 117b11f19e..9d1cfef5f5 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -20,7 +20,7 @@ Regardless of which option you choose, before posting your request please do the - Make sure the link you want to add is stable, and works properly. To check this, open it in one of your usual players (for example, [VLC media player](https://www.videolan.org/vlc/index.html)) and watch the broadcast for at least a minute (some test streams are interrupted after 15-30 seconds). - Make sure the link is not already in the playlist. This can be done by [searching](https://github.com/search?q=repo%3Aiptv-org%2Fiptv+http%3A%2F%2Fexample.com&type=code) the repository. -- Make sure the link does not lead to a Xtream Codes server. [Why don't you accept links to Xtream Codes servers?](FAQ.md#why-dont-you-accept-links-to-xtream-codes-server). If you're unsure, please check [How to distinguish a link to an Xtream Codes server from a regular one?](#how-to-distinguish-a-link-to-an-xtream-codes-server-from-a-regular-one) +- Make sure the link does not lead to a Xtream Codes server. [Why don't you accept links to Xtream Codes servers?](FAQ.md#why-dont-you-accept-links-to-xtream-codes-servers). If you're unsure, please check [How to distinguish a link to an Xtream Codes server from a regular one?](#how-to-distinguish-a-link-to-an-xtream-codes-server-from-a-regular-one) - Make sure that the link leads directly to the broadcast, without unnecessary redirects. - Find the ID of the channel you want on [iptv-org.github.io](https://iptv-org.github.io/). If your desired channel is not on the list, you must add it via a request [here](https://github.com/iptv-org/database/issues/new/choose). - Make sure the channel is not blacklisted. It can also be done through [iptv-org.github.io](https://iptv-org.github.io/). From 8551b76b52a09fe2a0c20efff63a5c7323a2cf69 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Isma=C3=ABl=20Moret?= <30985701+BellezaEmporium@users.noreply.github.com> Date: Wed, 27 May 2026 19:21:22 +0200 Subject: [PATCH 4/4] Update FAQ.md Co-authored-by: Aleksandr Statciuk <7253922+freearhey@users.noreply.github.com> --- FAQ.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/FAQ.md b/FAQ.md index 2f50bcb213..74e968e403 100644 --- a/FAQ.md +++ b/FAQ.md @@ -13,7 +13,7 @@ No. ### Why is the channel on the iptv-org.github.io but not in the playlist? The site is an extensive database of all existing TV channels in the world, and does not represent a list of streams in our possession. Only those of them for which we have working stream links are included in the playlists. -You may still check [iptv-org.github.io](https://iptv-org.github.io) with the "feeds:>1" parameter in the search bar to check all available feeds. +You may still check [iptv-org.github.io](https://iptv-org.github.io) with the "streams:>0" parameter in the search bar to check all available streams. ### Can I add a radio broadcast?