Перейти к содержимому

Как настроить EPG для IPTV: телепрограмма в плеере

Как подключить телепрограмму (EPG) в IPTV-плеере: ссылка XMLTV в плейлисте и в настройках TiviMate и OTT Navigator, привязка по tvg-id, сдвиг времени.

Обновлено: (Опубликовано: )

💡︎ Главные мысли статьи:

  • Телепрограмма для IPTV — это файл XMLTV (обычно .xml.gz). Плеер сопоставляет его с каналами плейлиста по tvg-id, а если его нет — по названию.
  • Ссылку на EPG можно прописать в самом плейлисте атрибутом url-tvg или добавить вручную в настройках плеера.
  • Если программа сдвинута на целое число часов, исправьте часовой пояс приставки и сдвиг времени для источника EPG в плеере.
Премиум IPTV
0 ₽ • Без оплаты
Шаровоз: 2 300+ каналов и 4K кинозалы
Все включено
3$/ мес(~240 ₽)
Тест 24ч без оплаты→
ИИ-иллюстрация: Иллюстрация: сетка телепрограммы в IPTV-плеере

Чтобы в 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

  1. У провайдера. Ссылка обычно есть в личном кабинете или уже прописана в плейлисте. Это лучший вариант.
  2. Публичные источники. Например, на момент написания отвечали http://epg.it999.ru/edem.xml.gz и http://www.teleguide.info/download/new3/xmltv.xml.gz (оба адреса перенаправляют на зеркала). Это сторонние сервисы: они могут сменить адрес или закрыться, а идентификаторы каналов в них не всегда совпадают с вашим плейлистом.
  3. Собрать самому. Проект iptv-org/epg позволяет собирать XMLTV с сайтов телепрограмм на своём компьютере или в Docker. Подробнее в статье про плейлисты с GitHub.

Настройка в TiviMate

  1. Откройте Настройки → EPG и добавьте источник: выберите ввод URL и вставьте ссылку XMLTV.
  2. Проверьте, что источник выбран для нужного плейлиста (в настройках плейлиста есть выбор источников EPG).
  3. Запустите обновление EPG и дождитесь загрузки.
  4. Если какой-то канал остался без программы, откройте его меню долгим нажатием OK и вручную привяжите программу из загруженного источника.

Подробно о TiviMate: настройка TiviMate Premium.

Настройка в OTT Navigator

  1. Откройте настройки провайдера или плейлиста и найдите раздел телепрограммы (EPG).
  2. Добавьте свою ссылку XMLTV, если программа не пришла из плейлиста.
  3. Обновите данные. OTT Navigator умеет брать программу из нескольких источников сразу.

Подробнее: настройка OTT Navigator на Android TV.

Программа сдвинута по времени

Если передачи в сетке начинаются на несколько часов раньше или позже реального эфира:

  1. Проверьте время на приставке. В настройках Android выберите правильный часовой пояс и включите автоматическую установку даты и времени по сети. Большинство проблем решается на этом шаге.
  2. Задайте сдвиг в плеере. В TiviMate и OTT Navigator для источника EPG можно указать сдвиг в часах (например, +2 или -1). Используйте его, только если источник действительно отдаёт неверное время, иначе сдвиг «поедет» после исправления часового пояса.
  3. Сравните с другим источником. Если ошибка только на части каналов, источник может отдавать время в разных поясах для региональных версий каналов (например, «+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 вручную.