电视盒子影视聚合工具 TVBoxOSC:不编译、不折腾,最新 TVBox 安装包 3 步到手

电视盒子影视聚合工具 TVBoxOSC:不编译、不折腾,最新 TVBox 安装包 3 步到手

【免费下载链接】TVBoxOSCTVBoxOSC - 一个基于第三方项目的代码库，用于电视盒子的控制和管理。项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC

家里的盒子、智能电视明明连着大屏,自带的商店却全是广告,影视类应用还不好找?TVBoxOSC 帮你跳过"找包、编译"这两步:它盯着两个 TVBox 开源分支的最新代码,自动打包出签好名的 APK,你只需下载、安装、填片源,3 步就能让电视盒子跑上最新版的 TVBox 影视应用。

先搞清楚它是什么:专给 TVBox 打包装的"车间"

TVBox 是 Android 电视盒子上的开源播放应用,靠"配置源"加载影视内容,在盒子圈很常见。而 TVBoxOSC 这个仓库和它不太一样——仓库里不存放应用代码,它是一条自动打包流水线:

• 盯两条上游:同时跟踪 q215613905 的 TVBoxOS 和 takagen99 的 Box(两个都在维护的 TVBox 分支),各构建一个版本;
• 有新提交才动手:检测到上游有新代码才重新编译发布,没有就跳过,不重复出包;
• 产物拿来即用:APK 用固定签名证书打包,下载就能装,Release 里还附带由上游提交记录生成的更新日志;
• 来路清晰:README 的 Credits 写明了它依赖的三个上游项目(含 CatVodTVOfficial/TVBoxOSC),代码从哪来、到哪一版,都查得到。

一句话:你负责用,它负责把最新的 TVBox 编译好。

3 类人最适合:不想碰编译、想要最新版

• 只想看片、不想开电脑装开发工具的人:不用 Android Studio、不用 JDK,下载 APK 直接装;
• 手头版本太旧的人:上游作者不一定频繁出安装包,这个流水线每天自动盯上游提交,有新代码就有新包;
• 想横向对比两种 TVBox 的人:两个版本代码基不同,都装上试试,哪个在你的盒子上播得顺就留哪个。

3 步从下载装到开机看片

环境要求:绝大多数 Android 盒子都能装,留 100MB 左右空间足够;系统具体支持情况以 Release 页说明为准,装不上就换个版本试。

1. 下包:打开 TVBoxOSC 的 Release 页,取最新一次发布,下载TVBox_*.apk。文件名形如TVBox_<上游作者>_<日期>.apk,同一版一般有两个分支的包,先挑一个即可;
2. 安装:把 APK 传到盒子,用文件管理器打开安装;弹出安全提示时,允许"安装未知应用";
3. 启动并加载内容:首次进入应用,在设置里填入一个 JSON 配置源地址,保存后刷新。首页能刷出节目单,就算跑通了。

仓库本身只有构建流程、不含 APK,所以日常使用只走上面三步。只有想查看或修改这条自动打包线时,才需要把代码拉到本地:

git clone https://gitcode.com/GitHub_Trending/tv/TVBoxOSC

装完做 3 件事:选版本、填源、遥控操作

选版本:两个包对应两条上游代码线,接口和细节略有差异,不猜不选,都装上实测,留播放更稳的那个。Release 里还附了sourceCode-*.tar.xz源码包,想核对这版基于哪个提交,解开看就行。

填片源:TVBox 这类应用的核心输入是 JSON 配置源地址,社区里流传不少。地址填进应用设置后刷新,能出列表就说明源是活的;遇到加载不动的源,直接换一个,别在坏源上耗时间。

遥控三连:方向键移动焦点、确认键进入、返回键退出,选片、播放、暂停全靠这三键,全程不用找遥控器上那些看不清的键位。

装不上、打不开、播不动?一张表对号入座

进阶:看懂自动打包,或自己跑一次构建

顺着流程读一遍。整条产线写在 .github/workflows/test.yml,逻辑很短,按顺序看一遍就懂:

1. 每天 06:59(UTC)定时触发,也可在平台上手动触发;
2. 先比对上游最新提交和 README 里记录的上次构建号,一致就结束——避免同一个版本反复打包;
3. 有新提交才克隆上游源码,然后做几处构建期修改:注入版本号和构建日期、修补 maven 源、写入签名配置;
4. 用./gradlew assemblerelease构建,takagen99 这条线固定走 Java 17 环境;
5. 从上游提交日志生成更新日志,作为 Release 说明,并用 .github/scripts/upload.py 把新包推到项目的 Telegram 频道;
6. 最后把新提交号写回 README,作为下一次的"构建记号"。

手动触发时还有rebuild(强制忽略构建记录)和donotpublish(只构建不发布)两个选项,维护者验证改动时用得上。

想改构建本身?版本号注入规则、源修补这些都在工作流的修改段里,全仓库就几个文件,核心逻辑都集中在这一份 workflow 里,改完手动触发一次就能验证。另外 .github/dependabot.yml 里配了 Dependabot 每天检查构建环境依赖,产线自己也会跟着更新。

周边入口:看代码、查文档、找更新

• 项目说明与上游致谢: README.md
• 自动构建流程(整条产线): .github/workflows/test.yml
• 社区分发脚本: .github/scripts/upload.py
• 构建依赖自动更新: .github/dependabot.yml

TVBoxOSC 替你省掉"去哪找 TVBox 包"和"怎么把它编译出来"这两件最烦的事,你只需要挑版本、安装、填源。现在就去 Release 页下载最新的 APK,两个分支都装上试一轮,哪个顺就用哪个。

【免费下载链接】TVBoxOSCTVBoxOSC - 一个基于第三方项目的代码库，用于电视盒子的控制和管理。项目地址: https://gitcode.com/GitHub_Trending/tv/TVBoxOSC