## 功能特性 - 🎛️ **EPG 时间轴网格** — 横向电子节目指南视图，带实时"当前"指示器 - 📱 **移动端适配** — 手机端优化的列表视图 - ▶️ **内置 HLS 播放器** — 点击频道即可在画中画窗口播放，HTTP→HTTPS 透明代理 - 📡 **多 EPG 源** — 配置多个 EPG/M3U 源，在顶栏切换 - 👤 **个人 EPG** — 允许访客使用自己的 EPG/M3U URL - 🗂️ **分类过滤** — 按电影、体育、新闻、儿童等分类筛选 - 🔍 **频道搜索** — 按频道名或节目标题/简介搜索（防抖处理） - ⭐ **收藏频道** — 置顶显示收藏频道（localStorage 持久化） - 🎨 **主题系统** — 4 套内置主题，支持自定义 CSS 主题 - 🌍 **多语言** — 自动检测浏览器语言，支持 EN/FR/ES - 🔔 **节目提醒** — 浏览器通知提醒即将播出的节目 - ⚙️ **可重编辑配置** — admin key 保护，无需 SSH 修改配置 - 🩺 **管理健康页** — 诊断配置、XMLTV/M3U 连通性、元数据覆盖率 - 🖨️ **24h 打印导出** — 生成 PDF/PNG 格式的每日节目单 - 🔄 **自动刷新** — 每 30 分钟自动刷新 EPG 数据 ### 初始配置向导 首次访问时，GridTV 检测到缺少配置文件会自动跳转到 Setup 页面： | **Group name** | 显示在顶栏左上角的名称（如 `家庭影院`） | | **EPG sources** | 添加 XMLTV 源 URL（必填）和 M3U 播放列表 URL（可选） | | **Personal EPG** | 是否允许访客使用自己的 EPG/M3U URL | 提交后会自动生成一个 **Admin Key**，请务必保存此密钥！后续修改配置需要输入此密钥。 > 💡 Admin Key 会自动保存在浏览器 localStorage 中，同一浏览器无需重复输入。后续如需修改来源，可在地址后面加上“/setup.php”来重新配置保存。 ### EPG 与 M3U 的关系 GridTV 需要两种数据源配合使用： | 数据源 | 格式 | 作用 | 是否必填 | |--------|------|------|----------| | **EPG (XMLTV)** | `.xml` / `.xml.gz` | 提供**节目指南**（频道名、节目标题、播出时间、简介） | ✅ 必填 | | **M3U 播放列表** | `.m3u` / `.m3u8` | 提供**视频流地址**（每个频道对应的直播流 URL） | ⚠️ 可选（无则不可播放） | 注：可用测试地址 Name: `中国频道`, EPG URL: `https://epg.pw/xmltv/epg_CN.xml`, M3U URL: `https://iptv-org.github.io/iptv/countries/cn.m3u` 注意：测试地址只是示例，如有播放源无法播放，需要对应替换成可用播放源即可解决。 **工作原理**： - EPG 决定时间轴网格中**显示什么频道和节目** → 无 EPG 则网格为空 - M3U 决定点击频道时**播放什么视频流** → 无 M3U 则只能看节目表不能播放 - 两者通过**频道名匹配**关联：EPG 中的频道名需要与 M3U 中的频道名一致才能正确匹配