5分钟搞定Kodi IPTV直播：IPTV Simple Client保姆级搭建指南
【免费下载链接】pvr.iptvsimpleIPTV Simple client for Kodi PVR项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple
还在被散落在各处的直播源折腾？打开Kodi找不到熟悉的频道，节目单还是空的？
pvr.iptvsimple（IPTV Simple Client）是Kodi的IPTV直播插件，装上它，M3U播放列表和XMLTV节目单就能变成Kodi里的完整电视直播体验。下面带你从零走到"能看台"。
它到底能帮你解决什么
多个直播源，合并成一个频道表
你手里有好几个M3U文件，有的来自不同服务商，有的放本地、有的在远端。插件的常规标签页里，M3U位置可以选本地路径或远程URL。远端地址还能勾选"缓存到本地"，网络抖动时也能照常看。
多套源各管各的场景，用"Add add-on configuration"添加第二套配置就行，互不干扰。
节目单补上，不用猜几点播什么
Kodi默认没有直播的节目时间表。给它配上XMLTV格式的EPG，频道列表旁边就会列出"现在播什么、下一个是什么"。
Gzip和XZ压缩的节目单它都能直接读，不用你提前解压。
看直播接个电话，回来接着看
直播一般只能"播"和"停"，按了暂停画面就没了。装上inputstream.ffmpegdirect这个输入流插件后，插件能把直播流做时移：暂停、往前回看刚才的片段，像操作点播一样。
回退多久由时移窗口决定，窗口内随你拖。
频道太多？按组整理干净
M3U里带group-title字段的频道会自动进组，左侧菜单一栏一组，找台不用从头滚到尾。
分组有三种模式：全部组、指定组（最多5个）、自定义组（读XML文件，数量不限）。
三步跑起来：装、配源、打开电视菜单
装插件：Kodi里进入"插件"→"从库安装"→"PVR客户端"，找到IPTV Simple Client装上。装完后，Kodi顶部多出一个"电视"入口。
配源：右键插件→"设置"，在常规标签页选择M3U位置，填入本地路径或远程URL。一个最简M3U长这样：
#EXTM3U #EXTINF:0 tvg-id="cctv1" group-title="新闻",央视一套 http://example.com/cctv1.ts #EXTINF:0 tvg-id="hunan" group-title="娱乐",湖南卫视 http://example.com/hunan.ts有了播放源，还得有节目单才能显示时间表。
补节目单：设置里的EPG标签页，同样选本地路径或远程URL，填入XMLTV地址。保存后不用额外操作，插件会按配置自动刷新。
打开：点顶部"电视"进入PVR界面。左侧是频道组，右侧是当前和接下来的节目——能看到这两样，就说明配好了。
再玩点花样
让直播能暂停能回看
时移的前提你已经知道：装inputstream.ffmpegdirect。然后在插件设置的"时移"标签页勾选"启用时移"，选对适用范围（HTTP流或全部流）。
⚠️ 注意：个别流默认不走时移输入流，需要在M3U里手动声明：
#KODIPROP:inputstream=inputstream.ffmpegdirect #KODIPROP:inputstream.ffmpegdirect.stream_mode=timeshift #KODIPROP:inputstream.ffmpegdirect.is_realtime_stream=true这三行放在对应频道的#EXTINF行之前。保存后，暂停键就会把画面"存住"。
给频道换一套自己的图标
频道图标标签页选"本地路径"，指向一个放满PNG图标的文件夹，图标按频道命名。
⚠️ 注意：图标文件名必须和M3U里频道的
tvg-id或频道名对得上，对不上就不会显示。
用XML文件自定义频道分组
设置里的"分组"标签页把TV分组模式改为"自定义组"，指向你自己的XML文件，格式很简单：
<channelGroups> <group name="体育"> <channel name="体育频道" /> <channel name="足球频道" /> </group> </channelGroups>name是频道在M3U里的显示名，按名字匹配，不用管编号。
⚠️ 注意：官方自带的示例配置文件每次启动插件都会被覆盖，自定义请另存一个新文件名，改完后清一次PVR缓存再试。
卡住了？先查这几处
画面一直转圈，就是出不来？
你可以试试这几步：先拿浏览器直接打开M3U里的直播URL，确认它本身能播；再看URL是不是完整地址（有些源只给了半截）；高级设置里的超时、自动重连参数按你的网络调一调；最后确认该流需要的输入流插件已装好。
频道名和节目对不上号？
节目单是拿tvg-id和XMLTV的channel id对号入座的，先核对两边是否一致。对不上就启用"忽略EPG频道ID大小写"；时间整体偏移，多半是时区问题，用EPG时间偏移（-12到+14小时）修正；再不行看channel的display-name能不能和tvg-name、频道名对上。
时移勾了也无效？
检查输入流插件是否真的装好并启用；确认是HTTP/UDP这类流才有时移；存储和带宽要留够余量；TS流的时移建议按上面示例加mimetype属性，加载会快一些。
README.md里有全部字段的说明，更深的细节都查得到。
从M3U到XMLTV再到打开电视菜单，三步你就有了一套完整的IPTV直播。明天先装好插件、填上第一个M3U地址试试；再卡住，就去Kodi官方论坛的PVR版块提问，那里回复最快。
【免费下载链接】pvr.iptvsimpleIPTV Simple client for Kodi PVR项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
