如何快速上手Kodi PVR IPTV Simple：打造终极家庭直播电视体验 📺

Kodi PVR IPTV Simple是一款专为Kodi媒体中心设计的开源直播电视与广播客户端插件，支持Gzip和XZ压缩的XMLTV电子节目指南，从Kodi 20（Nexus）版本起可通过多组M3U/XML文件配置，轻松实现IPTV直播、时移回看和视频点播功能。本文将带你从安装到高级设置，全方位掌握这款强大工具。

🚀 一分钟了解核心优势

作为Kodi生态中最受欢迎的IPTV插件之一，PVR IPTV Simple凭借以下特性脱颖而出：

• 多源配置：支持同时添加多个M3U播放列表和XMLTV节目指南，轻松管理不同来源的频道
• 智能压缩：自动处理Gzip/XZ压缩的节目指南数据，节省带宽并加速加载
• 灵活时移：配合inputstream.ffmpegdirect实现直播暂停、回退和快进功能
• 点播整合：将VOD内容显示为PVR录制项，支持按标题、季节分组管理
• 高度定制：通过自定义配置文件实现频道分组、提供商映射和节目类型分类

Kodi PVR IPTV Simple插件图标，象征着无缝连接IPTV服务与Kodi媒体中心的核心功能

⚡ 超简单安装步骤（支持全平台）

方法1：通过Kodi官方仓库安装（推荐新手）

1. 打开Kodi → 进入「插件」→ 选择「从库安装」
2. 依次进入「PVR客户端」→ 找到「IPTV Simple Client」
3. 点击「安装」并等待完成，重启Kodi后即可在PVR部分看到插件

方法2：手动编译安装（高级用户）

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源码环境支持，适合开发者或需要最新特性的用户

🎯 快速配置指南：3步搞定直播电视

1️⃣ 添加M3U播放列表

• 进入插件配置界面（Kodi → 插件 → 我的插件 → PVR客户端 → IPTV Simple → 配置）
• 在「常规」标签页选择「位置」（本地文件或远程URL）
• 输入M3U文件路径/URL，建议启用「缓存M3U到本地存储」提高加载速度

2️⃣ 配置电子节目指南（EPG）

• 切换到「EPG」标签页，同样选择XMLTV文件的位置
• 如需调整节目时间，可设置「EPG时间偏移」（-12小时至+14小时）
• 高级用户可启用「忽略EPG频道ID大小写」解决匹配问题

3️⃣ 自定义频道分组

• 在「组」标签页选择分组模式（全部组/部分组/自定义组）
• 如需过滤特定频道组，可选择「部分组」并输入要加载的组名称
• 自定义组功能需通过XML文件实现，默认文件路径为customTVGroups-example.xml

多配置文件设置界面示意图 通过「添加新的插件配置」功能，可同时管理多个M3U/XMLTV文件组合

🔍 常见问题解决方案

📺 直播流无法播放怎么办？

1. 检查输入流设置：在「高级」标签页确认是否选择了正确的输入流（ffmpeg/inputstream.adaptive/inputstream.ffmpegdirect）
2. 验证M3U格式：确保播放列表符合标准格式，包含正确的#EXTINF标签和流URL
3. 网络诊断：通过「M3U检查超时」设置（默认10秒）排查网络连接问题

⏪ 如何启用时移功能？

1. 在「时移」标签页启用「启用时移」选项
2. 推荐使用inputstream.ffmpegdirect并设置：

#KODIPROP:inputstream=inputstream.ffmpegdirect
#KODIPROP:inputstream.ffmpegdirect.stream_mode=timeshift

3. TS流用户建议添加#KODIPROP:mimetype=video/mp2t加速初始加载

📼 配置节目回看（Catchup）功能

1. 在「回看」标签页启用「启用回看」
2. 根据服务商类型选择「频道支持回看模式」（默认/追加/SIPTV/Flussonic等）
3. 设置「回看窗口」（默认7天），或在M3U中通过catchup-days标签单独指定

🛠️ 高级技巧：释放插件全部潜力

🎨 自定义频道图标

1. 在「频道图标」标签页设置图标来源（本地文件夹或远程URL）
2. 推荐图标尺寸：100x100像素PNG格式，文件命名建议使用tvg-id值
3. 可选择图标优先级（优先M3U/优先XMLTV）

📊 节目类型颜色编码

通过「genres.xml」文件映射节目类型与颜色：

<genres>
  <genre name="电影" id="1" color="#FF0000"/>
  <genre name="体育" id="10" color="#00FF00"/>
</genres>

放置位置：userdata/addon_data/pvr.iptvsimple/genres.xml，需重启Kodi生效

📱 将VOD整合为录制项

在「媒体」标签页启用：

• 「显示媒体为录制项」：将VOD内容显示为PVR录制
• 「按标题分组条目」：自动创建虚拟文件夹整理系列内容
• 「强制所有M3U条目为媒体」：适合纯点播内容的播放列表

📚 资源与支持

官方文档与工具

• 配置示例：src/iptvsimple/utilities/
• 支持的M3U/XMLTV元素：附录说明

获取帮助

• Kodi PVR用户论坛：https://forum.kodi.tv/forumdisplay.php?fid=167
• 插件问题追踪：项目GitHub Issues页面

---

Kodi PVR IPTV Simple凭借其轻量化设计和强大功能，成为打造家庭媒体中心的理想选择。无论是新手用户快速搭建直播电视，还是高级用户自定义复杂的媒体库结构，这款插件都能满足你的需求。立即下载体验，开启你的家庭娱乐新方式吧！

提示：定期更新插件可获得更好的兼容性和新功能支持，建议关注项目发布页面。