IPTVnator（增强版）：一款更适合国内 IPTV 的桌面播放器

前阵子我们介绍过一款Windows端IPTV播放器- IPTVnator，（见此文：IPTVnator：可能是目前PC端最舒服的一款开源M3U  IPTV 播放器）

这次分享的是一个基于上游项目持续优化的版本?

? IPTVnator（增强版），更适合国内用户使用。

项目地址：
https://github.com/CGG888/iptvnator

IPTVnator 是一款：

• ? 跨平台 IPTV 播放器

• ? 开源（MIT License）

• ? 支持 Windows / macOS / Linux

• ? 支持 m3u / m3u8 播放列表

• ? 支持 XMLTV 节目单（EPG）

你可以：

• 导入本地播放列表 ?

• 或使用远程 URL ?

• 直接加载频道并播放 ?

? 应用基于 Electron + Angular 构建，界面现代，体验统一。

⚠️ 重要说明

• IPTVnator 不提供任何播放列表或内容

• 所有频道仅为演示用途

• 需要用户自行导入 IPTV 源

这个版本最大的特点就是?

? 在不改变原有架构的前提下，专门针对中国 IPTV 场景做兼容性优化

优化方向主要集中在：

• 播放器选择

• EPG 匹配

• URL 规范化处理

? 不内置任何资源，只提升“可用性 + 稳定性”

?1、组播 / 单播智能适配

针对国内常见 IPTV 类型，做了自动识别?

✅ 自动识别来源

• ? 组播 / 网关：

• udp / rtp / 239.x

• .ts / .flv / .mpegts

• ? 单播：

• m3u8 / mp4

✅ 自动选择播放内核

• 组播 ? 使用 mpegts.js

• 单播 ? 使用 HTML5（hls.js）

? 提升兼容性，减少手动切换

✅ 地址自动清理（非常关键）

很多 IPTV 源会带类似内容：

http://xxx/rtp/239.x.x.x$组播超高清-50fps

优化逻辑：

• $ 后内容仅用于展示标签

• 播放前自动剥离

• 自动清理无效参数

? 避免播放失败问题

⏪ 2、回看（时移）支持

支持基于 XMLTV 的回放机制?

✅ 支持两类模板格式

格式一：

{utc:yyyyMMddHHmmss}
{utcend:yyyyMMddHHmmss}

格式二：

${(b)yyyyMMdd|UTC}
${(e)yyyyMMdd|UTC}

✅ 回看机制说明

• 点击 EPG 节目 ? 自动生成回放地址

• 自动替换时间参数

• 自动选择合适播放器

✅ 默认规则

• ? 默认支持 7 天回看

• ⛔ 无 catchup-source → 不支持回看

• ? 可被频道参数覆盖（timeshift / catchup.days）

✅ 优化点

• 首次回放自动做 URL 合法化

• 自动预选播放器

• 减少播放失败概率

? 实际体验：点击节目即可回看

? 3、4K / 画质策略优化

针对高码率 IPTV 流做了优化?

✅ 播放策略

• 单播 4K ? 使用 HTML5（hls.js）

• 提升稳定性

✅ 来源标签显示

切换频道时显示：

• 组播 / 单播

• UHD / HD / SD

• 帧率（fps）

? 方便快速识别画质

? 4、EPG 匹配与可视化增强

这一块是体验提升非常明显的部分?

✅ 匹配策略优化

• 优先使用 tvg-id 精确匹配

• 名称归一化处理：

• 去空格

• 去符号

• 去画质标识

• 支持模糊匹配

✅ 显示效果优化

• ? 正在直播

• ? 正在回放

• ⚪ 已播 / 待播

同时：

• 信息浮层显示状态

• 中文化展示

? 节目单终于“对得上 + 看得懂”

? 5、频道列表体验优化

一些非常实用的细节?

• ?️ 台标统一尺寸（48×32）

• ? 等比居中 + 白底

• ? 同名频道自动合并（区分 4K）

• ? 顶部工具栏快速切源

? 更清爽、更好用

? 播放能力

• 支持 m3u / m3u8

• 支持 Xtream Codes（XC）

• 支持 Stalker Portal（STB）

? 播放器支持

• HTML5（hls.js）

• Video.js

• 外部播放器（VLC / mpv）

? 播放列表

• 本地导入

• URL 导入

• 启动自动更新

• 支持自定义 User-Agent

? 频道功能

• 搜索频道

• 分组显示

• 收藏管理

⏱️ EPG / 回看

• XMLTV 节目单

• 节目详情展示

• 回看 / 时移

? 其他

• 多语言支持（含中文）

• 明暗主题切换

• 提供 Docker 自托管版本

? 前往 Releases 页面获取：

https://github.com/CGG888/iptvnator/releases

• Windows

• macOS

• Linux

  下载对应版本安装即可使用。

? Linux 安装方式

Snap：

sudo snap install iptvnator

Arch Linux：

yay -S iptvnator-bin

? 自托管（Docker）

支持以 PWA 方式运行：

• 浏览器访问

• 局域网使用

• 多设备共享

? 适合做家庭 IPTV 中心

?️ 本地构建

前置条件：

• Node.js

• npm

安装依赖：

npm install

构建桌面应用：

npm run electron:build:windows
npm run electron:build:mac
npm run electron:build:linux

开发模式：

npm run start

浏览器访问：

http://localhost:4200

这个版本 IPTVnator，本质上做了一件很明确的事情?

? 在不改变原有架构的前提下，让播放器更适配国内 IPTV 使用环境

没有增加复杂功能，也没有内置资源，
只是把这些关键点打磨好了：

• 组播 / 单播兼容

• 回看机制

• EPG 匹配

• 4K 播放

• URL 规范化

? 但正是这些细节，决定了实际使用体验。