把 Kodi 接上 IPTV 直播pvr.iptvsimple 落地实操手册【免费下载链接】pvr.iptvsimpleIPTV Simple client for Kodi PVR项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimplepvr.iptvsimple 是一个开源 PVR 插件负责把 M3U 频道列表和 XMLTV 节目指南接进 Kodi让你在 Kodi 里直接收看 IPTV 直播。本文面向想自建频道、又不想写代码的家庭用户覆盖从安装插件、录入第一个播放源到整理频道分组、打开直播回看的完整流程。跑起来之前 项目最低要求缺了会怎样Kodi20Nexus及以上推荐 21PiersPVR 客户端列表里看不到 IPTV Simple 选项装都装不上inputstream.ffmpegdirect与 Kodi 同版本直播只能看不能暂停时移回看功能整个不可用网络能访问 M3U 与节目指南地址频道列表空白TV 菜单卡在加载状态磁盘剩余几十 MB 即可时移缓冲写满后暂停失效、画面卡住装插件本身没有门槛插件 → 插件浏览器 → 从库安装 → PVR 客户端找到 IPTV Simple Client 装上然后到 系统设置 → PVR 客户端 里把它启用。装完先别急着配确认 TV 入口里出现了一个空的频道列表说明 PVR 后端已经接上了。主流程 接入第一个 M3U 播放列表操作路径插件 → 设置 → 选择 IPTV Simple Client → 常规 标签页。关键配置把 M3U 文件位置填成远程地址或本机路径。新手建议先用本地文件跑通#EXTM3U #EXTINF:0 tvg-idcctv1 group-title新闻,CCTV-1 http://192.168.1.10:8080/live/cctv1.ts #EXTINF:0 tvg-idhunan group-title综艺,湖南卫视 http://192.168.1.10:8080/live/hunan.ts验证信号打开 Kodi 主界面的 TV → 频道能看到上面两个频道名点进去能出声出画面即成功。tvg-id 字段决定这个频道能否匹配到节目单建议认真填写。为 Kodi IPTV 配置 XMLTV 节目单操作路径插件设置 → EPG 标签页。关键配置把 XMLTV 文件位置指向你的节目指南文件支持 .xml、.gzGzip和 .xzXZ三种压缩格式。两个参数建议核对一遍EPG 时间偏移小时0 忽略 EPG 频道 ID 大小写开时间偏移在默认 0 的情况下指南时间戳和 Kodi 本机时间要有时差才需要改大小写开关默认就是开的一般不用动。验证信号选中任意频道TV 信息栏显示当前节目 起止时间节目指南页里该频道有一串节目条目。若某些频道显示无数据是那些频道的 tvg-id 没匹配上见后文踩坑部分。用频道分组整理电视列表操作路径插件设置 → 组 标签页。关键配置模式有三档。默认是全部频道即列表里出现所有组第二档指定频道组适合列表特别长、只想留几类的情况第三档自定义频道组读一个 XML 文件分组完全由你定义。文件放在插件数据目录下的 channelGroups 子目录插件已预置一个示例文件改完文件名或直接用示例文件填内容即可channelGroups group name我的新闻 channel idcctv1 / channel idcctv13 / /group /channelGroups验证信号切到自定义频道组模式后TV 频道列表只出现我的新闻一个组组内是刚才列出的两个频道。打开直播暂停与时移回看操作路径插件设置 → 时移 标签页。关键配置把启用时移打开HTTP 和 UDP 两类源默认都允许。这一步依赖前文提到的 inputstream.ffmpegdirect对 HTTP/UDP 源它会默认启用时移模式从你按下播放的那一刻开始缓冲。验证信号正在播放的频道按暂停画面定格按快进能回到刚才看过的片段。如果暂停后直接退出播放说明时移没生效按下面踩坑第 4 条处理。把体验再拧一格 频道台标。默认状态台标只来自 M3U 里的 tvg-logo列表里很多频道是纯色块。建议值在 台标 标签页填一个台标图片库的根地址本地目录或远程 URL来源优先级选优先使用节目指南里的台标。改完的变化M3U 没给图、但 XMLTV 里带图的频道列表里也会显示台标。节目类型颜色。默认状态所有节目类型都是同一颜色扫一眼指南分不清电影和新闻。建议值在 节目类型 标签页指向一个 genres.xml 映射文件给常用类型配上颜色。改完的变化节目指南里电影体育等类型名变成对应颜色扫列表时定位节目更快。列表自动刷新。默认状态禁用M3U 文件变更后要重启 Kodi 才生效。建议值刷新模式选每天一次放在凌晨。改完的变化上游改了频道或加台第二天打开 TV 菜单自动就是新列表不用手动碰。踩坑速查 ⚠️症状TV 菜单空白连频道都没有。根因M3U 文件没下载下来或者文件根本不是合法 M3U缺 #EXTM3U 头。 动作插件设置 → 常规 标签页把文件位置临时改成本机放好的文件确认能出频道再换回网络地址换回后仍空白就用浏览器直接打开那个 URL打不开就是上游的问题。症状部分频道没有节目单信息。根因M3U 的 tvg-id 和 XMLTV 里的频道 ID 对不上最常见的是大小写不一致。 动作插件设置 → EPG 标签页确认忽略 EPG 频道 ID 大小写处于开启状态默认开仍不行的话用文本编辑器对比两边的 ID 拼写把 M3U 里的 tvg-id 改成和节目指南一致。症状节目单时间整体偏移固定几个小时。根因节目指南源时区和 Kodi 本机时区不一致。 动作插件设置 → EPG 标签页把EPG 时间偏移小时改成 -8 或 8 这类整点值重新选台看当前节目时间是否和本地时钟对得上。症状直播无法暂停或按暂停后画面退出。根因inputstream.ffmpegdirect 没装或者该频道是多播流不走时移模式。 动作先装 inputstream.ffmpegdirect 并重启 Kodi若确认是组播地址udp:// 开头到插件设置 → 高级 标签页打开转换多播流 URL按提示配好 udpxy 中继地址再试。往后走源码构建需要一份 Kodi 源码树把插件克隆到与之平级的目录即可git clone https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple cd pvr.iptvsimple mkdir build cd build cmake -DADDONS_TO_BUILDpvr.iptvsimple -DADDON_SRC_PREFIX../.. ../../xbmc/cmake/addons make版本上注意Kodi 20Nexus对应插件 v21.xKodi 21Piers对应 v22.x两者都支持多实例配置即添加多组 M3U/XMLTV 对来管理不同来源。想再深入可以去 Kodi 官方论坛搜 IPTV Simple 版块catchup 回放、请求头定制这类进阶配置都有现成讨论。到这里你已经有自己的直播频道、节目单和暂停回看了。插件更新比较频繁定期在插件仓库查看更新遇到异常先确认 M3U 源本身还能用再排查插件设置。【免费下载链接】pvr.iptvsimpleIPTV Simple client for Kodi PVR项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考