如何快速上手Kodi PVR IPTV Simple：打造终极家庭直播电视体验 📺
项目地址: https://gitcode.com/gh_mirrors/pv/pvr.iptvsimple 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官方仓库安装（推荐新手）
- 打开Kodi → 进入「插件」→ 选择「从库安装」
- 依次进入「PVR客户端」→ 找到「IPTV Simple Client」
- 点击「安装」并等待完成，重启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文件组合
🔍 常见问题解决方案
📺 直播流无法播放怎么办？
- 检查输入流设置：在「高级」标签页确认是否选择了正确的输入流（ffmpeg/inputstream.adaptive/inputstream.ffmpegdirect）
- 验证M3U格式：确保播放列表符合标准格式，包含正确的
#EXTINF标签和流URL - 网络诊断：通过「M3U检查超时」设置（默认10秒）排查网络连接问题
⏪ 如何启用时移功能？
- 在「时移」标签页启用「启用时移」选项
- 推荐使用inputstream.ffmpegdirect并设置：
#KODIPROP:inputstream=inputstream.ffmpegdirect
#KODIPROP:inputstream.ffmpegdirect.stream_mode=timeshift
- TS流用户建议添加
#KODIPROP:mimetype=video/mp2t加速初始加载
📼 配置节目回看（Catchup）功能
- 在「回看」标签页启用「启用回看」
- 根据服务商类型选择「频道支持回看模式」（默认/追加/SIPTV/Flussonic等）
- 设置「回看窗口」（默认7天），或在M3U中通过
catchup-days标签单独指定
🛠️ 高级技巧：释放插件全部潜力
🎨 自定义频道图标
- 在「频道图标」标签页设置图标来源（本地文件夹或远程URL）
- 推荐图标尺寸：100x100像素PNG格式，文件命名建议使用
tvg-id值 - 可选择图标优先级（优先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凭借其轻量化设计和强大功能，成为打造家庭媒体中心的理想选择。无论是新手用户快速搭建直播电视，还是高级用户自定义复杂的媒体库结构，这款插件都能满足你的需求。立即下载体验，开启你的家庭娱乐新方式吧！
提示：定期更新插件可获得更好的兼容性和新功能支持，建议关注项目发布页面。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
