Kodi IPTV直播系统搭建全解：三步从M3U源到EPG节目指南
【免费下载链接】pvr.iptvsimpleIPTV Simple client for Kodi PVR项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple
如果你已经有一批M3U直播源和XMLTV节目指南文件，Kodi直播插件IPTV Simple可以用几步配置把它们变成一套能看的直播电视系统，不需要写任何代码。
⚡ 它能做什么：IPTV Simple 能力速览
| 能力 | 说明 |
|---|---|
| 多M3U源合并 | 自Kodi 20起可同时配置多组M3U/XMLTV对，把不同服务商的频道整合到一起 |
| XMLTV EPG解析 | 读取XMLTV格式节目指南，支持Gzip和XZ压缩，自动把频道与节目匹配 |
| Kodi时移回看 | 配合inputstream.ffmpegdirect可暂停、回退直播流，并回放过去时段的历史节目 |
| 频道分组管理 | 全部/部分/自定义三种模式，只加载你想看的分组 |
| 图标与类型颜色 | 自定义频道图标，用genre映射文件给EPG节目做颜色编码 |
| VOD点播整合 | 把点播内容以PVR录制项形式列出，按标题和季自动归组 |
🔧 从零到能看：M3U播放列表配置与XMLTV节目指南接入
先装插件。打开Kodi，进入“附加程序 → 从仓库安装 → PVR客户端”，安装“IPTV Simple Client”，再到PVR设置里启用它。
再配M3U播放列表。在插件设置的“常规”标签页选择位置（本地路径或远程URL），填上M3U路径。M3U文件的最小要求是频道名和流地址：
#EXTM3U #EXTINF:0 tvg-id="cctv1" tvg-name="央视一套" group-title="直播",央视一套 http://example.com/cctv1.ts #EXTINF:0 tvg-id="hunan" tvg-name="湖南卫视" group-title="直播",湖南卫视 http://example.com/hunan.ts其中tvg-id是和节目指南匹配的关键，group-title用于频道分组，建议都保留。
然后接XMLTV节目指南。在“EPG”标签页填入XMLTV文件的本地或远程路径，匹配的前提是XMLTV里的channel id和M3U的tvg-id一致：
<tv> <channel id="cctv1"> <display-name>央视一套</display-name> </channel> <programme start="20260822190000 +0800" stop="20260822200000 +0800" channel="cctv1"> <title>新闻联播</title> </programme> </tv>如果节目单时间整体偏差，在设置里调整“EPG时间偏移”（-12到+14小时）；如果频道和节目匹配不上，先启用“忽略EPG频道ID大小写”。到这一步，打开直播电视就能同时看到频道列表和节目单了。
🎨 让画面更专业：界面、信息、内容三层调优
界面——频道图标。在“频道图标”标签页指向一个本地图标目录或基础URL，本地图标按频道ID或tvg-id命名（推荐PNG）。M3U和XMLTV里都带logo时，可以设置优先使用哪一边。
信息——类型颜色。插件把XMLTV里的category读作类型文本，再用映射文件把文本对应到genreId，就能给EPG做颜色编码，映射文件默认放在userdata/addon_data/pvr.iptvsimple/genres路径下：
<genres> <name>My Genre Mappings</name> <genre genreId="0x10">电影</genre> <genre genreId="0x20">新闻</genre> <genre genreId="0x40">体育</genre> </genres>内容——分组与VOD。当你手里有十个分组但只想看两个时，把TV分组模式切到“自定义分组”，指向自己维护的XML（从userdata/addon_data/pvr.iptvsimple/channelGroups目录的customTVGroups-example.xml复制一份修改，示例文件每次启动都会被覆盖，别直接改它）。VOD内容则在M3U里用EXT-X-PLAYLIST-TYPE: VOD属性或media属性标记，并在“媒体”标签页启用“Show media as recordings”，这些内容就会出现在PVR录制区；再开启按标题、按季分组，系列节目会自动归类。
🛠️ 出了问题怎么查：症状与排查方向对照
| 症状 | 排查方向 |
|---|---|
| 频道列表是空的 | 检查M3U路径或URL是否可访问、文件是否以#EXTM3U开头，以及“M3U检查超时”设置是否过短 |
| EPG不显示节目 | 核对XMLTV的channel id与M3U的tvg-id是否一致；尝试启用“忽略EPG频道ID大小写”；确认“EPG时间偏移”取值合理 |
| 直播流播放失败 | 先用浏览器打开流地址验证是否有效；检查inputstream组件选择；必要时在URL后附加所需HTTP请求头 |
| 时移回看无法使用 | 确认“启用时移”已勾选、inputstream.ffmpegdirect已安装，并且存储空间充足 |
| 多播udp://流打不开 | 在“高级”标签页启用多播中继（udpxy），把多播转成HTTP单播 |
💻 想折腾源码？
想获取最新特性或参与贡献的话，可以自行编译这个Kodi直播插件（需要先准备Kodi源码树xbmc）：
git clone https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple cd pvr.iptvsimple && mkdir build && cd build cmake -DADDONS_TO_BUILD=pvr.iptvsimple -DCMAKE_BUILD_TYPE=Release ../../xbmc/cmake/addons make && make install编译产物放入Kodi的addons目录后即可开始调试最新功能。
配置完成后，建议定期关注插件版本并更新，各项设置的完整说明可查阅项目内的README.md。
【免费下载链接】pvr.iptvsimpleIPTV Simple client for Kodi PVR项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
