Автообновляемые IPTV-плейлисты

Web-версия: https://iptv.axenov.dev/
FAQ: https://iptv.axenov.dev/faq
Зеркало репозитория: https://git.axenov.dev/anthony/iptv

Проект, содержащий в себе инструменты для работы с IPTV-плейлистами:

• список автообновляемых плейлистов, которые найдены в открытых источниках;
• скрипты для поиска каналов в этом списке, создания своего плейлиста;
• веб-сервис, предоставляющий короткие ссылки на эти плейлисты и отображающий список каналов.

Плейлисты подбираются преимущественно для РФ и любых стран бывшего СНГ, но этими странами список не ограничивается.

Поддержкой этих плейлистов занимаются сервисы и ресурсы, указанные как источник. Вопросы работоспособности плейлистов адресуйте тем, кто несёт за них ответственность.

Они бесплатны для использования. Список проверяется и обновляется мной вручную. Гарантию работоспособности никто не даёт.

English description

Mirrored repo: https://git.axenov.dev/anthony/iptv

This repo contains IPTV-playlists free to use with your media-player.

Most of them are in russian or CIS languages but you can find something interesting here for yourself.

Also there are some handy tools to make your own playlist or find channels you want in playlists listed here.

You can use this repo according to LICENSE conditions.

I'm too lazy to translate and support the whole project in ru and en, sorry, guys.

---

Содержание

• Как использовать этот список?
• Формат playlists.ini
• API
• Развёртывание проекта
• Дополнительные инструменты
• Как создать свой собственный плейлист
• Использованный стек
• Лицензия

---

Как использовать этот список?

Чтобы подключить плейлист, нужно в настройках медиаплеера указать ссылку в следующем формате:

iptv.axenov.dev/<ID>
iptv.axenov.dev?<ID>  (устаревший формат)
iptv.axenov.dev/?<ID> (устаревший формат)

где <ID> - один из идентификаторов, указанных в playlists.ini в квадратных скобках.

Либо провернуть всё то же самое через браузер.

Формат playlists.ini

# В квадратных скобках - ID плейлиста в рамках этого
# конфига (обязателен). Для удобства ввода с пульта,
# для ID рекомендуется число или короткая строка без
# пробелов и др. спецсимволов.
[1]

# Название плейлиста (необязательно)
name = 'Рабочий и актуальный IPTV плейлист M3U'

# Краткое описание из источника или от себя (необязательно)
desc = 'В этом IPTV плейлисте вы найдете очень много каналов в HD качестве'

# Прямая ссылка на m3u/m3u8 плейлист (обязательно)
pls = 'https://example.com/pls.m3u'

# Ссылка на источник, откуда взят плейлист (необязательно)
src = 'https://example.com/super-duper-playlist'

[2]

# ID другого плейлиста в этом списке, на который
# произойдёт редирект. Нужен для мягкой смены ID.
redirect = 1

В описании плейлиста обязательны:

• любой желаемый ID в квадратных скобках;
• либо pls, либо redirect (если указаны оба, то redirect приоритетен).

Плейлистов с редиректами может быть сколько угодно, но они не должны быть цикличными.

API

Можно получать состояние плейлистов из этого сборника при помощи метода:

GET https://iptv.axenov.dev/<ID>/json

где ID -- один из идентификаторов, указанных в playlists.ini в квадратных скобках.

В случае успеха вернётся JSON следующего содержания:

{
    "id": "p1",
    "url": "localhost:8080/p1",
    "name": "Каналы в SD и HD качестве (smarttvnews.ru)",
    "desc": "Рабочий и актуальный IPTV плейлист M3U — на июнь 2022 года",
    "pls": "https://smarttvnews.ru/apps/iptvchannels.m3u",
    "src": "https://smarttvnews.ru/rabochiy-i-aktualnyiy-iptv-pleylist-m3u-kanalyi-v-sd-i-hd-kachestve/",
    "status": "online",
    "encoding": {
        "name": "UTF-8",
        "alert": false
    },
    "channels": [
        "Channel1",
        "Channel2",
        "ChannelX"
    ],
    "count": 3
}

где:

• id -- название плейлиста
• name -- краткое описание из источника или от себя
• url -- короткая ссылка, которую можно использовать для добавления плейлиста в плеер
• desc -- подробное описание плейлиста
• pls -- прямая ссылка на m3u/m3u8 плейлист
• src -- ссылка на источник, откуда взят плейлист
• status -- признак доступности плейлиста (online, timeout, offline, unknown)
• encoding -- данные о кодировке файла плейлиста
  • name -- название кодировки (на данный момент определяются только UTF-8 или Windows-1251)
  • alert -- признак отличия кодировки от UTF-8, названия каналов сконвертированы в UTF-8
• channels -- массив названий каналов
• count -- количество каналов >= 0

Название кодировки encoding.name может определяться неточно!

В случае ошибки вернётся JSON в следующем формате:

{
    "id": "p1",
    "url": "localhost:8080/p1",
    "name": "Каналы в SD и HD качестве (smarttvnews.ru)",
    "desc": "Рабочий и актуальный IPTV плейлист M3U — на июнь 2022 года",
    "pls": "https://smarttvnews.ru/apps/iptvchannels.m3u",
    "src": "https://smarttvnews.ru/rabochiy-i-aktualnyiy-iptv-pleylist-m3u-kanalyi-v-sd-i-hd-kachestve/",
    "status": "offline",
    "error": {
        "code": 22,
        "message": "The requested URL returned error: 404 Not Found"
    }
}

где:

• id -- название плейлиста
• name -- краткое описание из источника или от себя
• url -- короткая ссылка, которую можно использовать для добавления плейлиста в плеер
• desc -- подробное описание плейлиста
• pls -- прямая ссылка на m3u/m3u8 плейлист
• src -- ссылка на источник, откуда взят плейлист
• status -- признак доступности плейлиста (online, timeout, offline, error)
• error -- данные о кодировке файла плейлиста
  • code -- код ошибки curl
  • message -- текст ошибки curl

Развёртывание проекта

1. Выполнить cp .env.example .env, установить необходимые параметры
2. Выполнить docker compose up -d --build
3. Открыть https://<APP_URL>:8080

Дополнительные инструменты (./tools)

download-all.sh

Скачивает все плейлисты из playlists.ini в локальную директорию ./downloaded/.

check-pls.sh

Проверяет каждый канал в плейлисте на доступность и выводит результат проверки.

Поддерживаются *.m3u и *.m3u8; как локальные файлы, так по прямым ссылкам.

Коды ошибок доступны здесь.

Пример:

$ ./tools/check-pls.sh my.m3u8
Playlist: my.m3u8

Note 1: operation may take some time.
Note 2: press CTRL+C to skip current channel or CTRL+Z to kill process.
Note 3: results may be inaccurate, you should use proper IPTV software to re-check.
Note 4: error codes listed here - https://everything.curl.dev/usingcurl/returns
--------------------
[1] Канал Disney...
	- OK: "http://ott-cdn.ucom.am/s60/04.m3u8"
[2] Канал Disney...
	- ERROR 28 (-): "http://92.243.113.179:8080/Disney_Channel/index.m3u8?token=nts_tv"
[3] Disney канал ...
	- OK: "http://ott-cdn.ucom.am/s60/index.m3u8 "
[4] Канал Disney...
	- OK: "http://ott-cdn.ucom.am/s60/04.m3u8"
[5] Fox_Life_HD...
	- ERROR 6 (-): "http://live-ng-01.more.tv/hls/Fox_Life_HD/index_1.m3u8"
[6] FOX_HD...
	- ERROR 22 (404): "http://live-ng-01.more.tv/hls/FOX_HD/index_1.m3u8"
...
--------------------
Playlist: my.m3u8
Check stats
- Success:      995/999
- Failed:       4/999

find-in-pls.sh

Находит каналы по заданному регулярному выражению в одном указанном плейлисте.

Поддерживаются *.m3u и *.m3u8; как локальные файлы, так по прямым ссылкам.

Пример:

$ ./tools/find-in-pls.sh disney a.m3u8
--------------------
Playlist: a.m3u8
Channel to find: disney
--------------------

267 FOUND:	#EXTINF:-1 group-title="Disney" tvg-id="disney",Disney (1)
		http://zabava-htlive.cdn.ngenix.net/hls/CH_DISNEY/bw2000000/variant.m3u8?version=2

270 FOUND:	#EXTINF:-1 group-title="Disney" tvg-id="disney",Disney (2)
		https://okkotv-live.cdnvideo.ru/channel/Disney.m3u8
--------------------
Playlist: a.m3u8
Channel found: disney
Found: 2

find-in-all.sh

Находит каналы по заданному регулярному выражению во всех плейлистах, скачанных через download-all.sh.

Пример:

$ ./tools/find-in-all.sh (disney|СТС)
...
--------------------
Playlist: ./downloaded/kids.m3u.1
Channel to find: (disney|СТС)
--------------------

35 FOUND:	#EXTINF:-1 tvg-name="СТС Kids HD" group-title="Детские", СТС Kids HD
		https://okkotv-live.cdnvideo.ru/channel/CTC_Kids_HD.m3u8

59 FOUND:	#EXTINF:-1 tvg-name="Disney канал" group-title="Детские", Disney канал
		http://zabava-htlive.cdn.ngenix.net/hls/CH_DISNEY/bw2000000/variant.m3u8?version=2

83 FOUND:	#EXTINF:-1 tvg-name="Канал Disney (okko tv)" group-title="Детские", Канал Disney (okko tv)
		https://okkotv-live.cdnvideo.ru/channel/Disney.m3u8
--------------------
Playlist: ./downloaded/kids.m3u.1
Channel found: (disney|СТС)
Found: 3
--------------------
Playlist: ./downloaded/kz-all.m3u
Channel to find: (disney|СТС)
--------------------
Nothing found
...

make-pls.sh

Находит каналы по заданному регулярному выражению во всех плейлистах, скачанных через download-all.sh.

Отличается от find-in-all.sh тем, что тот выводит результат в человекочитаемом формате, а этот -- в готовом m3u формате для сохранения в файл.

Пример:

./tools/make-pls.sh "(fox|disney)"
#EXTM3U
# Autogenerated at 09.06.2022
# https://github.com/anthonyaxenov/iptv

#EXTINF:-1,Канал Disney
http://ott-cdn.ucom.am/s60/04.m3u8

#EXTINF:-1,Канал Disney
http://92.243.113.179:8080/Disney_Channel/index.m3u8?token=nts_tv

#EXTINF:-1 ,Fox HD
http://live02-cdn.tv.ti.ru:80/dtv/id376_NBN_SG--Fox_HD/04/plst.m3u8
...

Как создать свой собственный плейлист?

1. Скачать все плейлисты, указанные в playlists.ini:

   $ ./tools/download-all.sh
   

2. Вытащить из них нужные каналы и сохранить в отдельный файл:

   $ ./tools/make-pls.sh "(fox|disney)" > my.m3u8
   

   Так в плейлисте ./my.m3u8 окажутся все каналы из скачанных плейлистов, в названиях которых встретились fox или disney.
3. Проверить доступность каналов в полученном плейлисте:

   $ ./tools/check-pls.sh my.m3u8
   

   Результат ОК не означает, что канал действительно работает и отдаёт видео/аудио потоки.
   Результат ERROR с любыми кодами ошибок гарантированно означает, что канал не работает.

4. Вручную: удалить нерабочие, мусорные и продублировавшиеся (по ссылкам) каналы.
5. Вручную: добавить плейлист в IPTV-плеер и перепроверить результат.

Использованный стек

• docker compose
• php8.1-fpm
• FlightPHP
• Bootstrap 5
• nginx
• bash

Лицензия

The MIT License