iptv/.readme/template.md

125 lines
3.6 KiB
Markdown
Raw Normal View History

2019-10-09 04:33:52 +02:00
# IPTV
2021-08-12 06:52:19 +02:00
[![auto-update](https://github.com/iptv-org/iptv/actions/workflows/auto-update.yml/badge.svg)](https://github.com/iptv-org/iptv/actions/workflows/auto-update.yml)
2021-04-17 04:32:23 +02:00
Collection of publicly available IPTV channels from all over the world.
2019-10-09 04:33:52 +02:00
2021-01-14 18:29:46 +01:00
Internet Protocol television (IPTV) is the delivery of television content over Internet Protocol (IP) networks.
2019-10-09 04:33:52 +02:00
## Usage
2021-05-07 17:36:03 +02:00
To watch IPTV you just need to paste this link `https://iptv-org.github.io/iptv/index.m3u` to any player which supports M3U-playlists.
2019-10-09 04:33:52 +02:00
2021-01-18 17:41:07 +01:00
![VLC Network Panel](.readme/preview.png)
2019-10-09 04:33:52 +02:00
2019-11-02 12:08:02 +01:00
Also you can instead use one of these playlists:
2019-10-09 04:33:52 +02:00
- `https://iptv-org.github.io/iptv/index.country.m3u` (grouped by country)
- `https://iptv-org.github.io/iptv/index.category.m3u` (grouped by category)
2019-10-31 12:59:08 +01:00
- `https://iptv-org.github.io/iptv/index.language.m3u` (grouped by language)
2021-06-05 16:52:38 +02:00
- `https://iptv-org.github.io/iptv/index.nsfw.m3u` (includes adult channels)
2019-10-09 04:33:52 +02:00
Or select one of the playlists from the list below.
2021-04-26 20:38:38 +02:00
### Playlists by category
2019-10-09 04:33:52 +02:00
2021-02-26 23:08:34 +01:00
<details>
<summary>Expand</summary>
<br>
2021-01-16 01:54:50 +01:00
<!-- prettier-ignore -->
#include "./.readme/_categories.md"
2019-10-09 04:33:52 +02:00
2021-02-26 23:08:34 +01:00
</details>
2021-04-26 20:38:38 +02:00
### Playlists by language
2019-10-31 12:59:08 +01:00
2021-02-26 23:08:34 +01:00
<details>
<summary>Expand</summary>
<br>
2021-01-16 01:54:50 +01:00
<!-- prettier-ignore -->
#include "./.readme/_languages.md"
2019-10-31 12:59:08 +01:00
2021-02-26 23:08:34 +01:00
</details>
2021-04-26 20:38:38 +02:00
### Playlists by country
2019-10-09 04:33:52 +02:00
2021-02-26 23:08:34 +01:00
<details>
<summary>Expand</summary>
<br>
2021-01-16 01:54:50 +01:00
<!-- prettier-ignore -->
#include "./.readme/_countries.md"
2020-05-04 16:02:18 +02:00
2021-02-26 23:08:34 +01:00
</details>
2021-05-07 17:36:03 +02:00
2020-05-04 16:02:18 +02:00
## For Developers
In addition to the above methods, you can also get a list of all available channels in JSON format.
To do this, you just have to make a GET request to:
```
2020-05-06 17:02:54 +02:00
https://iptv-org.github.io/iptv/channels.json
2020-05-04 16:02:18 +02:00
```
If successful, you should get the following response:
2021-02-27 10:40:50 +01:00
<details>
<summary>Expand</summary>
<br>
2020-05-04 16:02:18 +02:00
```
[
...
{
"name": "CNN",
"logo": "https://i.imgur.com/ilZJT5s.png",
"url": "http://ott-cdn.ucom.am/s27/index.m3u8",
"category": "News",
2021-01-29 20:19:44 +01:00
"languages": [
2020-05-04 16:02:18 +02:00
{
"code": "eng",
"name": "English"
}
],
2021-01-29 20:19:44 +01:00
"countries": [
{
"code": "us",
"name": "United States"
},
{
"code": "ca",
"name": "Canada"
}
],
2020-05-04 16:02:18 +02:00
"tvg": {
"id": "cnn.us",
"name": "CNN",
"url": "http://epg.streamstv.me/epg/guide-usa.xml.gz"
}
},
...
]
```
2021-02-26 23:08:34 +01:00
</details>
2020-05-04 16:02:18 +02:00
2021-09-25 16:07:29 +02:00
## EPG
Playlists already have a built-in list of EPG, so players that support the `url-tvg` tag should load it automatically. If not, you can find a list of available programs here:
https://github.com/iptv-org/epg
2019-10-09 04:33:52 +02:00
## Resources
You can find links to various IPTV related resources in this repository [iptv-org/awesome-iptv](https://github.com/iptv-org/awesome-iptv).
2019-10-09 04:33:52 +02:00
2021-02-27 10:40:50 +01:00
## Contribution
2021-03-01 16:27:13 +01:00
Please make sure to read the [Contributing Guide](CONTRIBUTING.md) before sending an issue or making a pull request.
2021-02-27 10:40:50 +01:00
2021-01-14 18:29:46 +01:00
## Legal
2021-02-26 23:08:34 +01:00
No video files are stored in this repository. The repository simply contains user-submitted links to publicly available video stream URLs, which to the best of our knowledge have been intentionally made publicly by the copyright holders. If any links in these playlists infringe on your rights as a copyright holder, they may be removed by sending a pull request or opening an issue. However, note that we have **no control** over the destination of the link, and just removing the link from the playlist will not remove its contents from the web. Note that linking does not directly infringe copyright because no copy is made on the site providing the link, and thus this is **not** a valid reason to send a DMCA notice to GitHub. To remove this content from the web, you should contact the web host that's actually hosting the content (**not** GitHub, nor the maintainers of this repository).