OrionTV

yaniswang/OrionTV 项目完整总结 一、项目基础定位 OrionTV 是开源跨平台电视端视频播放器，由 yaniswang 维护，fork 自 orion-lib/OrionTV，采用 MIT 开源协议；基于 React Native TVOS + Expo + TypeScript 开发，同时适配 Android TV、Apple TV，是电视端影视播放前端工具，1.2.x 及以上版本必须搭配 MoonTV 数据源使用。

二、核心技术栈 1. 核心框架：Expo 51、React Native TVOS、Expo Router（文件式路由）、Expo AV 播放器 2. 开发语言：TypeScript（占98.9%）+ 少量 JavaScript 3. 配套工具：Yarn 包管理、ESLint/Prettier 代码规范、Babel 编译 4. 配套服务：搭配独立 m3u8-proxy 代理项目优化流媒体播放 三、核心功能亮点 1. 双平台电视适配：UI 专为电视遥控器交互设计，一套代码打包安卓电视、苹果电视两端安装包 2. M3U8 流媒体代理：对接自研 m3u8-proxy，解决境外播放源晚高峰卡顿问题 3. 旧安卓设备兼容修复（重点迭代方向） - 修复安卓6播放时间格式显示异常 - 解决安卓6/7低版本不支持 Let’s Encrypt 证书、无法更新版本、退出重进无法播放的bug 4. 响应式布局：兼容手机、平板、电视多尺寸屏幕 5. 模块化分层架构：路由、组件、钩子、接口服务、常量完全解耦，易二次开发 四、项目目录架构（类 Monorepo） -  app ：Expo Router 页面与路由逻辑 -  components ：通用电视UI组件 -  hooks ：自定义业务钩子 -  services ：接口、本地存储等业务服务 -  constants ：全局样式、配置常量 -  assets ：图标、字体、截图静态资源 -  plugins/xml/utils ：工具函数、原生兼容补丁、配置插件 - 配套配置文件：babel、eslint、tsconfig、expo eas 打包配置等 五、开发部署流程 1. 环境依赖 Node.js LTS、Yarn、Expo CLI；苹果TV编译需Xcode，安卓TV需Android Studio 2. 常用命令 1.  yarn ：安装全部依赖 2.  yarn prebuild-tv ：生成适配电视的原生工程（首次必执行） 3.  yarn ios-tv ：编译运行 Apple TV 4.  yarn android-tv ：编译运行 Android TV 5.  yarn start-tv ：TV模式启动调试服务； yarn lint ：代码校验 六、迭代更新情况（截至2026-06-26最新版v1.3.20） 仓库总计239次提交，持续针对老旧安卓电视设备做兼容性优化，近期主要更新： 1. 2026-04：修复电视退出重进无法播放；升级Node至20版本 2. 2026-05：新增M3U8代理；修复低版本安卓SSL证书、版本更新失效问题 3. 2026-06：统一修复安卓6时间格式渲染bug，为各业务模块同步适配函数 早期迭代完成工程结构重构、日志统一、打包脚本优化、移动端自适应布局等基础改造 七、免责与版权说明 1. 仅作为视频搜索前端工具，不存储、分发任何影视内容，所有资源来自第三方API（MoonTV） 2. 用户使用需遵守当地法律法规，开发者不承担侵权、违规使用相关责任 3. 项目灵感参考 MoonTV、LibreTV 开源项目，API服务由 gpt-load 项目提供赞助支持 八、仓库基础信息 1. 分支：master 分支领先上游原仓库36次提交 2. 版本：6个正式Release，最新 v1.3.20（2026-06-26） 3. 现状：暂无外部贡献者，为单人维护开源项目 4. 配套依赖：播放加速依赖独立仓库 m3u8-proxy，数据源强制依赖 MoonTV 服务端 项目仅用于技术学习交流，不提供商业服务，聚合内容来自第三方，使用者需遵守当地法律法规。 下面设置后端地址 https://moontv.vime50.com/ https://www.nmxl.net/ https://tv.mock.moe/ https://moontv.001.sh/ https://www.librelist.org/ https://www.finger10.com/ https://ljiji.com/