Если в IPTV-плеере каналы переключаются, но сетка передач пуста, почти всегда причина в отсутствующей или битой ссылке на файл XMLTV-EPG — проверить это можно за минуту, открыв URL телегида прямо в браузере. Формат XMLTV — это стандарт описания телепрограммы в виде XML-файла, который плеер скачивает и сопоставляет со списком каналов из плейлиста M3U.
Без корректного EPG пользователь видит только названия каналов, без анонсов, таймкодов и описаний передач. В этой статье разберём, как устроен формат, где брать актуальные источники программы передач, как привязать EPG к каналам и что делать, если гид не загружается.
Что такое формат XMLTV и как он работает
XMLTV — это открытый текстовый формат на базе XML, описывающий телепрограмму: каналы, передачи, время начала и окончания, жанры и описания. Файл обычно имеет расширение .xml или сжатую версию .xml.gz, что уменьшает объём загрузки в разы.
Структура файла состоит из двух логических блоков. Первый — список каналов с уникальными идентификаторами, второй — массив передач, каждая из которых ссылается на канал через этот идентификатор. Плеер при запуске скачивает файл, парсит его и строит сетку программы.
<channel id="perviy">
<display-name>Первый канал</display-name>
</channel>
<programme start="20260101120000 +0300" stop="20260101130000 +0300" channel="perviy">
<title>Новости</title>
</programme>
Именно атрибут channel и id — ключевые точки сопоставления. Если они не совпадают с тем, что ожидает плеер, программа не отобразится, даже если файл скачался успешно.
Где брать источники XMLTV-программы передач
Существует три источника EPG: встроенный в плейлист от провайдера IPTV, сторонние публичные сервисы телегидов и самостоятельно собранный файл. У каждого варианта свои плюсы и ограничения.
- 📺 EPG от провайдера — ссылка часто уже прописана в плейлисте через параметр
url-tvg; наиболее точное сопоставление каналов. - 🌐 Публичные телегиды — агрегаторы, публикующие XMLTV-файлы по странам и операторам; удобны для эфирных каналов.
- 🛠 Собственный файл — полный контроль над источником, но требует регулярного обновления.
⚠️ Внимание: бесплатные публичные источники EPG периодически меняют адреса или прекращают работу. Если программа внезапно пропала, первым делом проверьте, открывается ли ссылка на XMLTV-файл в браузере.
Как подключить XMLTV к IPTV-плееру
Порядок действий зависит от приложения, но общая логика одинакова: плееру нужно указать URL файла телегида и, при необходимости, привязать каналы. Ниже — универсальный чек-лист, подходящий для большинства плееров на Android, Windows и Smart TV.
☑️ Подключение EPG к плееру
В популярных плеерах вроде TiviMate, OTT Navigator, Kodi или IPTV Pro настройка телегида находится в разделе источников данных. Точные названия пунктов меню отличаются между версиями приложений, поэтому ориентируйтесь на ключевые слова «EPG», «TV Guide» или «XMLTV».
После подключения дайте плееру время: полный XMLTV-файл на сотни каналов может весить десятки мегабайт, и первичная обработка занимает заметное время, особенно на слабых ТВ-приставках.
Сопоставление каналов: tvg-id и tvg-name
Самая частая причина «пустой» программы — рассинхронизация идентификаторов. В плейлисте M3U каждый канал может иметь атрибуты tvg-id и tvg-name, и плеер ищет по ним совпадения в XMLTV-файле.
#EXTINF:-1 tvg-id="perviy" tvg-name="Первый канал" tvg-logo="logo.png",Первый канал
http://example.com/stream/1
Если tvg-id в плейлисте не совпадает с channel id в XMLTV-файле, программа не привяжется. Многие плееры умеют сопоставлять по названию канала, но это ненадёжно: «Первый канал» и «Первый канал HD» для движка сопоставления могут оказаться разными сущностями.
Некоторые приложения позволяют вручную назначить EPG-источник конкретному каналу через контекстное меню. Это выход для «проблемных» каналов, у которых автоматическое сопоставление не сработало.
Типичные проблемы и их решение
Разберём симптомы, с которыми чаще всего сталкиваются пользователи при настройке XMLTV-программы передач.
| Проблема | Вероятная причина | Что проверить |
|---|---|---|
| Программа пустая у всех каналов | Недоступен URL телегида | Открыть ссылку на XMLTV в браузере |
| EPG есть только у части каналов | Не совпадают tvg-id | Сверить идентификаторы в плейлисте и XML |
| Передачи сдвинуты по времени | Неверный часовой пояс | Настройку смещения времени в плеере |
| Программа не обновляется | Отключено автообновление EPG | Интервал обновления в настройках |
| Долгая загрузка гида | Большой несжатый файл | Использовать версию .xml.gz |
Отдельно стоит проблема часовых поясов. Время в XMLTV указывается с учётом смещения (например, +0300), и корректные плееры пересчитывают его под локальное время устройства. Если передачи «уехали» на несколько часов, проверьте настройку смещения EPG в приложении — многие плееры позволяют задать сдвиг вручную.
⚠️ Внимание: не редактируйте XMLTV-файл в программах, меняющих кодировку. Файл должен оставаться в UTF-8 без BOM — иначе кириллические названия передач превратятся в нечитаемые символы, а некоторые парсеры откажутся загружать гид целиком.
Как проверить XMLTV-файл вручную
Откройте ссылку на EPG в браузере — должен скачаться файл .xml или .xml.gz. Распакуйте архив при необходимости и откройте файл в текстовом редакторе с поддержкой больших файлов. Убедитесь, что внутри есть блоки
Настройка автообновления и оптимизация
Телепрограмма устаревает ежедневно, поэтому плееру нужно регулярно скачивать свежий файл. В большинстве приложений есть параметр интервала обновления EPG — установите его в пределах 12–24 часов: чаще нет смысла, реже — сетка передач начнёт расходиться с реальным эфиром.
На слабых устройствах имеет смысл сократить объём данных:
- ⚡ Сжатый формат — всегда предпочитайте
.xml.gzобычному.xml, если источник предлагает оба варианта. - 📅 Глубина программы — ограничьте хранение EPG несколькими днями, если плеер позволяет.
- 🎯 Фильтрация каналов — некоторые источники позволяют скачивать гид только по нужным каналам.
Часто задаваемые вопросы
Чем XMLTV отличается от JTV?
JTV — более старый компактный бинарный формат телегида, популярный в простых плеерах. XMLTV — текстовый, расширяемый и поддерживает описания, жанры и иконки. Современные плееры работают преимущественно с XMLTV.
Почему плеер показывает «Нет данных» в программе передач?
Чаще всего URL телегида недоступен или идентификаторы tvg-id в плейлисте не совпадают с channel id в XMLTV-файле. Проверьте ссылку в браузере и сверьте идентификаторы.
Можно ли использовать несколько источников EPG одновременно?
Да, многие плееры (например, TiviMate, OTT Navigator) поддерживают несколько источников. Каналы без программы из основного источника могут подтянуть данные из резервного.
Как исправить смещение программы на несколько часов?
Проверьте настройку часового пояса или смещения EPG в плеере. Также убедитесь, что на самом устройстве выставлено корректное локальное время.
Безопасно ли использовать публичные XMLTV-источники?
Сам файл — обычный XML с текстом программы, исполняемого кода в нём нет. Однако скачивайте EPG только с известных источников и не вводите на таких сайтах личные данные или данные оплаты.