EPG · XMLTV

什么是 EPG？

EPG，即电子节目指南，是每个频道在什么时间播什么的列表。在 IPTV 中，它几乎总是一个 XMLTV 文件：一份有自己地址的文档，由播放器下载并排成节目指南。

Lumen·TV 是一款适用于 Android TV、Google TV、Fire TV和Android 手机和平板的 IPTV 播放器。需要 Android 8.0 或更高版本。它播放您已有的 M3U 或 Xtream Codes 播放列表，不包含任何频道。免费试用21天，之后一台设备每月 €0.99；或一次性支付 €19.99，可用2台设备；或一次性支付 €29.99，可用5台。试用无需绑卡，到期自动结束。

更新于 2026年10月28日

XMLTV 文件包含什么。

两种条目。指南涵盖的每个频道各有一个 <channel>，带 id 和名称；每个节目各有一个 <programme>，用该 id 指明所属频道，带开始时间、结束时间、标题，通常还有简介。

<tv>
  <channel id="news24.example">
    <display-name>News 24</display-name>
  </channel>
  <programme channel="news24.example" start="20261021190000 +0200" stop="20261021200000 +0200">
    <title>Evening bulletin</title>
    <desc>Headlines, weather, sport.</desc>
  </programme>
</tv>

一个频道及其中一个节目。每个时间都带有自己相对 UTC 的时差，这里是快两小时。

大小: 大型播放列表一周的节目数据可达许多 MB，所以节目指南常以压缩形式发布，即 .xml.gz。
能提前多久: 取决于发布者填了多少：几天、一周，有时更长。

节目指南如何找到您的频道：tvg-id。

节目指南和播放列表是两个独立的文件，常常来自不同的地方，把它们连起来的只有一样东西：M3U 播放列表中频道那一行的 tvg-id，必须与指南中某个频道的 id 完全一致。tvg-id="news24.example" 能找到 channel="news24.example" 的节目；tvg-id="News24" 则一个也找不到。

所以，当节目指南加载了却没有显示您频道的节目时，通常是因为两个文件对频道的命名不同，而只有发布它们的人才能让两者一致。Xtream Codes 服务器会同时发布频道列表和节目指南，所以两者通常是一致的。

节目指南的地址从哪里来。

使用 Xtream Codes 登录时: 服务器在 xmltv.php 发布节目指南，用同样的用户名和密码打开，所以播放器可以自己找到它。参见什么是 Xtream Codes。
使用 M3U 播放列表时: 节目指南是第二个地址，服务商通常会把它和播放列表链接一起发布。有些会把它写在播放列表的第一行，即 url-tvg；播放器会不会从那里读取，取决于播放器。
来自其他地方: 任何 XMLTV 地址都可以，只要它的 id 与播放列表的一致。

Lumen·TV 如何处理节目指南。

每个播放列表一个节目指南，以时间轴呈现，可一次翻半小时或一天，也会在画面上显示当前和下一个节目。
服务商发布多少天就显示多少天，最多七天。
Xtream Codes 登录或 get.php 链接会自己找到节目指南。普通的 M3U 则需要单独提供指南地址：Lumen·TV 不会读取写在播放列表里的地址。添加节目指南的详细步骤。
仅按 tvg-id 将节目与频道对应，既能读取压缩发布的节目指南（.xml.gz），也能读取未压缩的。
会说明节目指南为什么是空的：没有地址、地址里没有节目、频道没有 tvg-id、id 对不上任何频道，或者服务商已停止更新该指南。
将多个节目指南合并为一个、节目指南时间偏移和提醒，都不在应用的功能范围内。