#EXTM3U
#EXTINF:-1 tvg-id="trt1.tr" tvg-name="TRT 1 HD" tvg-logo="https://stream.example.com:8080/images/trt1.png" group-title="Ulusal",TRT 1 HD
https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
#EXTINF:-1 tvg-id="atv.tr" tvg-name="ATV HD" tvg-logo="https://stream.example.com:8080/images/atv.png" group-title="Ulusal",ATV HD
https://stream.example.com:8080/live/demo_user/demo_pass/102.m3u8
Техническая документация
Спецификация формата плейлистов M3U
Полная спецификация формата плейлистов M3U для IPTV. Изучите теги Уровней 1 и 2, парсинг каналов и проверяйте плейлисты интерактивно.
Введение в формат M3U в Mayk IP TV
Формат плейлистов M3U служит общепринятой основой для списков каналов IPTV. Mayk IP TV полноценно поддерживает как классические файлы M3U, так и современные плейлисты M3U8 с метаданными.
Структура и синтаксис плейлиста
Корректный файл M3U всегда начинается с директивы #EXTM3U, за которой следуют последовательные пары строк метаданных #EXTINF и прямых URL-адресов потоков.
Классификация фильмов и сериалов
Медиаконтент автоматически классифицируется как прямой эфир, фильм или эпизод сериала на основе шаблонов сезонов, таких как S01 E02.
Рекомендации по надежному парсингу
Всегда сохраняйте файлы в кодировке UTF-8, используйте прямые ссылки HTTP/HTTPS и уникальные значения tvg-id для точного телегида (EPG).
Уровень 1: Стандартные теги #EXTINF
| Поле / Тег | Уровень | Тип | Пример значения | Описание |
|---|---|---|---|---|
#EXTM3U | Стандартный (Уровень 1) · Обязательно | Directive (Header) | #EXTM3U | Обязательная строка заголовка, определяющая файл как расширенный плейлист M3U. |
#EXTINF | Стандартный (Уровень 1) · Обязательно | Directive (Metadata) | #EXTINF:-1 tvg-id="trt1" tvg-name="TRT 1",TRT 1 HD | Директива информации о дорожке, определяющая длительность и атрибуты метаданных. |
tvg-id | Стандартный (Уровень 1) · Необязательно | String | trt1.tr | Уникальный идентификатор, связывающий канал с записью в файле телепрограммы XMLTV EPG. |
tvg-name | Стандартный (Уровень 1) · Необязательно | String | TRT 1 HD | Официальное название канала, зарегистрированное в электронном телегиде. |
tvg-logo | Стандартный (Уровень 1) · Необязательно | URL (http/https) | https://stream.example.com:8080/images/trt1.png | Прямая веб-ссылка на изображение логотипа канала (желательно PNG или SVG по HTTPS). |
group-title | Стандартный (Уровень 1) · Необязательно | String | National | Название категории, в которую канал помещается в интерфейсе плеера. |
#EXTGRP: | Стандартный (Уровень 1) · Необязательно | Directive | #EXTGRP:National | Альтернативная директива группы, расположенная сразу за строкой EXTINF. |
Уровень 2: Расширенные теги Mayk IP TV
| Поле / Тег | Уровень | Тип | Пример значения | Описание |
|---|---|---|---|---|
media-type | Расширенный (Уровень 2) · Необязательно | Enum ("live" | "movie" | "series") | media-type="series" | Явное переопределение типа медиа: 'live', 'movie' или 'series'. |
series-id | Расширенный (Уровень 2) · Необязательно | String / Integer | series-id="show-42" | Уникальный идентификатор сериала, объединяющий потоки эпизодов. |
series-name | Расширенный (Уровень 2) · Необязательно | String | series-name="Example Series" | Каноническое название телесериала для объединения сезонов и серий. |
season | Расширенный (Уровень 2) · Необязательно | Integer | season="1" | Номер сезона для серий телевизионного проекта (целое число). |
episode | Расширенный (Уровень 2) · Необязательно | Integer | episode="4" | Номер серии внутри указанного сезона (целое число). |
is_adult | Расширенный (Уровень 2) · Необязательно | Integer ("0" | "1") | is_adult="1" | Индикатор родительского контроля: '1' отмечает контент для взрослых. |
age_rating | Расширенный (Уровень 2) · Необязательно | String | age_rating="18+" | Метка минимального возраста (например, '18+') для родительских фильтров. |
Правила классификации контента
| Тип | # | Пример значения |
|---|---|---|
| Прямой эфир | #3 | http(s)://... | media-type="live" |
| Фильм (VOD) | #2 | /movie/... | media-type="movie" |
| Серия сериала | #1 | /series/... + S01E01 / S01.E01 | media-type="series" |
Примеры шаблонов
#EXTM3U
#EXTINF:-1 tvg-logo="https://stream.example.com:8080/images/movie202.png" group-title="Sinema",Example Movie (2026)
https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
#EXTINF:-1 group-title="Dizi",Example Series - S01E01 - Pilot
https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4
#EXTINF:-1 media-type="series" series-name="Custom Show" season="1" episode="2" group-title="Dizi",Custom Show - S01E02
https://stream.example.com:8080/series/demo_user/demo_pass/30302.mp4
Интерактивная проверка формата
Вставьте фрагмент M3U или JSON-ответ Xtream ниже для проверки совместимости с Mayk IP TV.
Контрольный список совместимости M3U
- Убедитесь, что самая первая строка файла в точности равна #EXTM3U.
- Установите длительность в -1 для всех непрерывных каналов прямого эфира.
- Сопоставьте корректные значения tvg-id с вашим источником данных XMLTV.
- Логично группируйте каналы с помощью атрибута group-title.
- Сохраняйте файлы в чистой кодировке UTF-8 без метки порядка байтов (BOM).