MPV-IPTV-Player

项目概述

MPV IPTV Player 基于 mpv 播放器与 uosc 界面框架深度定制，为电视直播和回看功能而设计。它提供四级滑动菜单，从分组到频道、日期桶再到节目单，逐层展开；顶部搜索框只匹配频道名，并支持中文、拼音全拼与首字母。除了直播，它还支持 XMLTV 格式节目单与时间跳转回看，以及远程 M3U 订阅的缓存启动与后台刷新。

用遥控般的四级菜单，把 IPTV 直播与回看整理得井井有条。

主要功能

• 四级滑动菜单：按分组、频道、日期桶、节目单逐层展开，顶部可搜索频道
• 频道搜索：支持中文、拼音全拼与首字母，只匹配频道名而不误命中节目名
• 组内快速切台：直播时可按上一台、下一台在当前频道组内切换
• EPG 回看：支持 XMLTV 格式节目单与时间跳转回看
• 回看续播预加载：当前片段接近结束时提前排队下一段，减少续播卡顿
• 回看搜索：跨频道搜索所有可回看的节目，按时间倒序排列
• 远程订阅：可配置远程 M3U 地址，空载启动时先读本地缓存秒开，再后台刷新
• 强制刷新：一键强制刷新节目单，订阅模式下同时刷新 M3U 与节目单
• 历史记忆：自动保存并恢复上次播放的频道，快速切台时合并写盘减少 IO
• 智能右键：根据 IPTV 或普通视频场景显示不同的右键菜单

适用人群

• 使用 mpv 观看 IPTV 直播的用户
• 需要节目单与回看功能的电视直播用户
• 希望用键盘快捷键快速找台的用户

快速上手

1. 下载 mpv 播放器（推荐 Windows 构建版本）
2. 把仓库中的 portable_config 放入 mpv 根目录
3. 双击本地 M3U 文件，或在命令行执行 mpv tv.m3u
4. 按 F8 打开 IPTV 菜单，直接输入频道名即可筛选
5. 需要远程订阅时，把 M3U 地址写入 script-opts/epg.conf 的 m3u_download_url，然后空载启动 mpv
6. 按 Shift+F9 可强制刷新节目单，按 F9 可跨频道搜索可回看的节目

核心优势

• 菜单清晰：四级滑动菜单逐层展开，找台与看节目单都很直观
• 搜索贴心：支持中文、拼音与首字母，只匹配频道名避免误命中
• 回看顺畅：续播预加载提前排队下一段，减少切换时的卡顿
• 启动快速：远程订阅模式先用本地缓存秒开，再在后台刷新

系统要求

项目	要求
播放器	mpv
界面框架	uosc 5.12（已随配置提供并定制）
操作系统	Windows、Linux、macOS
数据源	M3U/M3U8 直播源，可选 XMLTV 节目单

注意事项

• 无节目单时请确认 x-tvg-url 可访问，并检查 epg.conf 中的下载地址
• 回看不生效时，请检查直播源中的 catchup-source 时间模板是否正确
• 部分频道在 mpv 中直接打开会失败，脚本仅在明确报错时对疑似 IPTV 源尝试 HLS 方式重试
• 本脚本仅供学习研究使用，请遵守当地法律法规并合理使用 IPTV 资源