guangyu

项目概述

当你要把几百条直播源整理成可用的频道列表并稳定播放时，光屿 GuangYu 提供了一套从扫描、清洗到观看的做法。桌面端用 Python 3.8+ 与 PySide6 6.4+ 构建，播放交给 MPV，流探测交给 FFprobe；Android 端是 Kotlin Compose 外壳加 Chaquopy 内嵌的 Python 3.11 后端。界面中英双语，采用液态玻璃质感。

项目	内容
平台	Windows / macOS / Linux / Android 9+
开发语言	Python + Kotlin
播放内核	MPV + FFprobe
界面框架	PySide6 6.4+
当前版本	50.0.6.1

从扫描到观看放在同一个窗口里，频道整理不再另开工具。

主要功能

• MPV 播放内核：支持 FCC 快速换台、硬件解码、HDR 五种模式、WCG 广色域与 minterpolate 运动补偿
• 时移与回看：支持 default、append、shift、flussonic、xtream 五种 catchup 类型，并处理时间变量替换与时区偏移
• EPG 匹配：解析 XMLTV 与 JSON 两种节目单，按 tvg-id → tvg-name → 频道名三级顺序匹配
• 台标系统：内置 400 多条匹配规则，支持在线加载、异步下载、本地缓存与 High-DPI
• 频道扫描：按 IP 段（如 239.3.1.[1-100]:8000）扫描，可设置超时与线程数，结果支持批量验证
• 字幕聚合：在线字幕同时查询 OpenSubtitles、SubHD、SubtitleCat 三个来源，并支持 IMDB 中转中文搜索
• 音频增强：10 段均衡器、7 种 3D 音频可视化样式、A/V 同步波形监控
• 多屏预览：支持 4 屏与 9 屏同播，配合书签、断点续播与片段导出

界面与操作

• 三栏布局：左侧 EPG 面板、中间播放区、右侧频道列表，底部是播放控制面板
• 面板开关：E 切换节目单、L 切换频道列表、M 切换控制面板、Y 隐藏或恢复所有悬浮面板
• 常用快捷键：Ctrl+O 打开播放列表、Ctrl+S 保存、F11 全屏、↑↓ 换台、滚轮调音量
• 列表交互：双击右侧频道开始播放，输入框实时过滤名称、URL 与分组（Ctrl+F）
• 主题切换：3 种颜色模式 × 7 种视觉风格，共 21 套组合即时生效

适用人群

• 自建 IPTV 源、需要批量整理频道的用户
• 管理大量订阅源与 EPG 地址的进阶用户
• 要在电视与桌面端保持统一观看体验的人
• 需要导出频道清单做交付的运维人员

快速上手

桌面端

1. 安装依赖：pip install -r requirements.txt
2. 把 MPV 与 FFmpeg 放进项目根目录的 mpv/ 与 ffmpeg/，Windows 对应 libmpv-2.dll 与 ffprobe.exe
3. 执行 python main.py 启动程序
4. 用 Ctrl+O 打开 .m3u / .m3u8 / .txt 列表，或直接把文件拖进窗口
5. 在「工具 → 订阅设置」添加播放列表与 EPG 地址，单击启用、双击编辑

Android 端

1. 进入 android/ 目录，执行 ./gradlew.bat assembleRelease
2. 需要单 ABI 时加 -PtargetAbi=arm64-v8a，可选 armeabi-v7a、x86_64、x86
3. 用 adb install -g app/build/outputs/apk/release/app-release.apk 覆盖安装，订阅与设置会保留
4. 数据统一写在 /sdcard/ISEP/，不会随 APK 更新丢失

核心优势

• 扫描到播放闭环：扫描、批量验证、清洗与播放共用同一份频道数据，结果可直接导出 M3U / TXT / Excel
• 播放参数可调：硬件解码、HDR、超分与插帧都在界面里切换，不必手改配置文件
• 双端同源：Android 端复用桌面端的 Python 业务后端，订阅、EPG 与播放逻辑保持一致
• 本地优先：频道、收藏、断点与书签写入本地文件，不依赖云端账号

系统要求

项目	要求
操作系统	Windows 10/11、macOS 10.15+、Linux x86_64/ARM64、Android 9.0（API 28）及以上
Python	桌面端 3.8+，Android 端内嵌 3.11
界面框架	PySide6 6.4+
内存	2 GB 及以上
外部依赖	MPV 与 FFmpeg，Linux 需装 libmpv-dev，macOS 可 brew install mpv ffmpeg

注意事项

• 二进制需自备：桌面端 mpv/ 与 ffmpeg/ 目录不在版本库中，缺少 libmpv 或 ffprobe 时播放与流检测不可用
• Android 数据目录：配置固定写入 /sdcard/ISEP/config.ini，该路径不可写时依次回退到应用外部目录与内部目录
• 内置 Web 服务：server_main.py 默认监听 127.0.0.1:8080，可用 --port 改端口
• Android 架构分包：不传 -PtargetAbi 时默认只含 arm64-v8a 与 armeabi-v7a，x86 系列需单独指定