Формат IPTV плейлистов

(Онлайн справочник радиолюбителя)

Плейлист (от англ. playlist - список воспроизведения) — текстовый файл, содержащий подборку видео или аудиоконтента (песен, инструментальных композиций, видеоклипов, фильмов, телепередач и т. д. ) для воспроизведения с помощью медиаплеера.

В этом материале мы разберем формат плейлиста применительно к IP-телевидению. Такие файлы имеют расширение .m3u и .m3u8. К сожалению, на них нет единого стандарта или спецификации, поэтому приведем обобщенное описание.

Структура формата .m3u

Первым возник формат .m3u. В самом простом варианте первая строка файла содержит инструкцию #EXTM3U, указывающую на начало и тип файла. В этой строке допускается через пробел указывать ряд необязательных параметров:

• время кэширования cache=xxx в миллисекундах;
• устранение черезстрочности (при формировании кадра из двух полукадров) deinterlace=y, где у может принимать значения 0 - выключено, 1 - включено, 2 — усреднение.
• предпочтительное соотношение сторон изображения aspect-ratio= "x:y", где x:y может принимать значения None, 16:9, 3:2, 4:3, 1,85:1, 2,39:1;
• ссылку на файл программы телепередач (Electronic Program Guide или EPG): url-tvg="http://xxx.xml", где xxx — URL-адрес телепрограммы;
• включение автозагрузки файла телепрограммы — m3uautoload=1;
• смещение во времени телепрограммы в часах tvg-shift=z, где z может принимать значения от -12 до +12;

Далее идут описания телеканалов, состоящие из двух или трех строк. В первой строке указывается инструкция #EXTINF: после которой указывается длительность трека в секундах. Применительно к IPTV (бесконечная длительность трансляции) этот параметр имеет значение 0 или -1. В этой строке может быть также указан необязательный параметр tvg-name="имя канала" — название канала для программы передач (EPG). Далее через запятую обязательно указывается название канала.

Вторая строка необязательная, в ней указывается инструкция #EXTGRP: и далее без пробелов и кавычек название группы каналов для объединения в плеере по группам. Следующая строка содержит URL-адрес телеканала. Ниже представлен примерный вид файла .m3u:

Структура формата .m3u8

Изначально формат .m3u8 создавался как копия формата .m3u в кодировке символов UTF-8, но применительно к IPTV он был несколько расширен, и типичная структура файла следующая:

В первой строке файла идет инструкция #EXTM3U, указывающая на начало и тип файла. Затем через пробел указывается ряд необязательных параметров, совпадающих с форматом .m3u.

Дальше следуют строки описания телеканалов. Инструкция #EXTGRP: в формате .m3u8 обычно не применяется, ее функцию добавили в строку #EXTINF. Строка заголовка канала #EXTINF:0 ( или #EXTINF:-1) содержит следующие параметры:

• group-title="имя" — название группы каналов (необязательный параметр);
• tvg-logo="адрес" — адрес иконки с логотипом канала (необязательный параметр);
• tvg-name="имя" — название канала для поиска в телепрограмме (необязательный параметр);
• tvg-rec="x" — количество дней в архиве для каналов, поддерживающих возможность просмотра уже прошедших передач (необязательный параметр);
• audio-track="x" – указывает какую звуковую дорожку использовать, например, en или ru (необязательный параметр);
• ,имя канала — название телепрограммы (обязательный параметр, должен быть последним в строке и начинаться с запятой).

Ниже представлен примерный вид файла .m3u8:

Большинство программ-проигрывателей понимают не все дополнительные параметры, причем каждый из них декодирует файл плейлиста по своему.

Для редактирования файла плейлиста IPTV можно использовать обычный блокнот (Notepad) или воспользоваться пробной версией нашего online редактора IPTV плейлистов.

Редактор плейлистов IPTV

Редактор работает только в десктопных версиях браузеров Chrome, Chromium, Erge, Opera, Yandex Browser, Vivaldi.

Для загрузки файла плейлиста служит клавиша "Загрузить". Можно загрузить несколько файлов для их объединения. При нажатии клавиши "Сохранить" плейлист будет сохранен в нужную папку на вашем компьютере. При нажатии на ячейку таблицы в одной из колонок "Название", "Группа", "Иконка", "TVG-имя", "URL Адрес" можно редактировать их значение для любого из каналов. При нажатии на номер канала выделяется вся строка. После этого для нее доступны операции по перемещению вниз или вверх или удалению канала. Повторное нажатие на номер канала снимает выделение.

Клавиши "Icon X>Y" и "URL X>Y" служат для массового переименования адресов иконок и адресов каналов (замены части строки текста на другой) по всем каналам.

Клавиша "EPG-тест" предназначена для проверки всех каналов на соответствие имен программе телепередач. Поддерживается только XML-формат телепрограммы. Если функция не работает, попробуйте в строке "Адрес программы (EPG):" заменить протокол с http:// на https://. Зеленым выделяются ячейки с названиями телеканалов, которые есть в файле телепрограммы, остальные выделяются розовым.

Клавиша "URL-тест" служит для массовой проверки ответа сервера URL телепрограмм. Если код ответа сервера 200, ячейка с адресом канала перекрашивается в зеленый цвет, иначе в розовый. Может работать очень долго.

Клавиша "Заполнить" служит для автоматической расстановки адресов иконок и названий телепрограмм в соответствии с файлом программы телепередач. Работает только после нажатия "EPG-тест".

Обсуждение редактора можно вести в комментариях ниже.