Как настроить EPG для IPTV: телепрограмма в плеере
Как подключить телепрограмму (EPG) в IPTV-плеере: ссылка XMLTV в плейлисте и в настройках TiviMate и OTT Navigator, привязка по tvg-id, сдвиг времени.
💡︎ Главные мысли статьи:
- Телепрограмма для IPTV — это файл XMLTV (обычно .xml.gz). Плеер сопоставляет его с каналами плейлиста по tvg-id, а если его нет — по названию.
- Ссылку на EPG можно прописать в самом плейлисте атрибутом url-tvg или добавить вручную в настройках плеера.
- Если программа сдвинута на целое число часов, исправьте часовой пояс приставки и сдвиг времени для источника EPG в плеере.
- 296 кинозалов BCU и 4K новинки
- Матч Премьер 50fps и архив 6 дней
- СБП (+20% бонус), карты РФ, МИР и ЕС
Чтобы в IPTV-плеере появилась телепрограмма, нужна ссылка на файл в формате XMLTV. Её дают провайдер или публичные сервисы. Ссылка добавляется либо в сам плейлист, либо в настройки плеера. Дальше плеер сопоставляет программу с каналами по идентификатору tvg-id или по названию. Ниже — как это сделать в TiviMate и OTT Navigator и что делать, если программа не совпадает.
Как EPG связан с плейлистом
EPG (Electronic Program Guide) — это XML-файл с расписанием передач, часто сжатый в .xml.gz. В M3U-плейлисте за связь с ним отвечают атрибуты:
#EXTM3U url-tvg="https://example.com/epg.xml.gz"
#EXTINF:-1 tvg-id="channel1" tvg-name="Канал 1" tvg-logo="https://example.com/logo.png",Канал 1 HD
https://example.com/live/channel1.m3u8
url-tvgв первой строке — ссылка на телепрограмму. Многие плееры подхватывают её автоматически (встречается и вариантx-tvg-url).tvg-id— идентификатор канала в файле XMLTV. Это самый точный способ привязки.tvg-name— название для сопоставления, еслиtvg-idнет или он не совпадает.tvg-logo— ссылка на логотип канала.
Если плейлист и EPG от одного провайдера, идентификаторы обычно совпадают, и программа появляется сама.
Где взять ссылку XMLTV
- У провайдера. Ссылка обычно есть в личном кабинете или уже прописана в плейлисте. Это лучший вариант.
- Публичные источники. Например, на момент написания отвечали
http://epg.it999.ru/edem.xml.gzиhttp://www.teleguide.info/download/new3/xmltv.xml.gz(оба адреса перенаправляют на зеркала). Это сторонние сервисы: они могут сменить адрес или закрыться, а идентификаторы каналов в них не всегда совпадают с вашим плейлистом. - Собрать самому. Проект iptv-org/epg позволяет собирать XMLTV с сайтов телепрограмм на своём компьютере или в Docker. Подробнее в статье про плейлисты с GitHub.
Настройка в TiviMate
- Откройте Настройки → EPG и добавьте источник: выберите ввод URL и вставьте ссылку XMLTV.
- Проверьте, что источник выбран для нужного плейлиста (в настройках плейлиста есть выбор источников EPG).
- Запустите обновление EPG и дождитесь загрузки.
- Если какой-то канал остался без программы, откройте его меню долгим нажатием OK и вручную привяжите программу из загруженного источника.
Подробно о TiviMate: настройка TiviMate Premium.
Настройка в OTT Navigator
- Откройте настройки провайдера или плейлиста и найдите раздел телепрограммы (EPG).
- Добавьте свою ссылку XMLTV, если программа не пришла из плейлиста.
- Обновите данные. OTT Navigator умеет брать программу из нескольких источников сразу.
Подробнее: настройка OTT Navigator на Android TV.
Программа сдвинута по времени
Если передачи в сетке начинаются на несколько часов раньше или позже реального эфира:
- Проверьте время на приставке. В настройках Android выберите правильный часовой пояс и включите автоматическую установку даты и времени по сети. Большинство проблем решается на этом шаге.
- Задайте сдвиг в плеере. В TiviMate и OTT Navigator для источника EPG можно указать сдвиг в часах (например,
+2или-1). Используйте его, только если источник действительно отдаёт неверное время, иначе сдвиг «поедет» после исправления часового пояса. - Сравните с другим источником. Если ошибка только на части каналов, источник может отдавать время в разных поясах для региональных версий каналов (например, «+2», «+4»). Привяжите такие каналы вручную к правильной версии.
Медленная загрузка и нехватка памяти
Полные файлы XMLTV на тысячи каналов бывают большими, и слабые приставки обрабатывают их долго. Что помогает:
- использовать сжатую версию
.xml.gz, если источник её даёт; - оставить один источник EPG вместо нескольких дублирующих;
- уменьшить срок хранения программы в настройках плеера (если такая настройка есть);
- скрыть ненужные группы каналов.
Нет логотипов каналов
Логотипы берутся из атрибута tvg-logo в плейлисте или из файла EPG. Если их нет, проверьте в настройках плеера, какой источник логотипов используется, и попробуйте переключить на другой.
Что почитать дальше
❓︎ Часто задаваемые вопросы (FAQ)
Почему передачи в телепрограмме сдвинуты на 2–3 часа?
Либо на приставке неверный часовой пояс, либо источник XMLTV отдаёт время с ошибкой. Сначала проверьте часовой пояс и автоматическую установку времени в Android, затем задайте сдвиг для источника EPG в настройках плеера.
Где взять ссылку на телепрограмму для российских каналов?
Надёжнее всего у своего IPTV-провайдера: его EPG сделан под названия и идентификаторы каналов в его плейлисте. Публичные источники тоже есть, но они меняют адреса и могут перестать работать.
Что делать, если у одного канала нет программы?
Его идентификатор или название не совпало с источником EPG. В TiviMate и OTT Navigator можно вручную назначить каналу программу из загруженного источника через меню канала.
Работает ли EPG при подключении через Xtream Codes?
Обычно да: сервер Xtream Codes отдаёт телепрограмму вместе с каналами, если провайдер её настроил. Если программы нет, добавьте ссылку XMLTV вручную.