这份清单收录 46 个与 TVBox 相关的 GitHub 仓库,包括原版源码存档、同源分支、协议重写版、服务端配套工具,以及已经消失的项目。每一条都带地址、语言、星数和最后一次提交时间,全部在 2026 年 11 月 6 日逐个实查过。
它是一份索引,不是评测——每个项目只给一句话定位,不展开分析。想知道哪一类适合你、二次开发该改哪一层,看站内另一篇《TVBox 二次开发项目盘点》。
一、原版与源码存档(2 个)
TVBox 的源代码起点是「猫影视」作者停更后公开的那份 Java 工程。官方仓库现在已经访问不了,但代码本身被完整搬运了下来,还在继续被人提交。
官方仓库消失后,这份独立重传的源码承接了整个社区。18k 星使它成为 TVBox 生态里关注度最高的仓库,也是绝大多数分支的真正上游。想看「原版长什么样」从这里入手。
2022 年 7 月的原始快照,描述里写着「基于 CatVodTVOfficial/TVBoxOSC 修改」。代码几乎未经改动,适合研究最初的工程结构——但别拿它当工程基础,太旧了。
二、同源分支:fork 官方源码(8 个)
这一类共用同一套 Java 代码底座,改 UI、换播放内核、适配老设备,成本最低。
兼容性最好的一条分支,老盒子和低版本 Android 基本靠它。界面朴素、改动克制,直播回放做得早。社区俗称「Q 版 / 俊版 / 蓝版」。
官方仓库的 fork,UI 改得最狠,也是这几条线里结构最清晰、最适合拿来做二次开发的起点。仓库描述只有「Experimental」一个词。2026 年 2 月后基本停更。
重做了多源处理逻辑,专门兼容 Android 4.4。库存老盒子、跑分低的电视棒可以试这个。
用 Kotlin 重写的 Android TV 版,支持电视直播、点播与遥控器操作,属于「在旧生态里用新语言写一遍」的尝试。
和同作者的 FreeBox 配套使用的安卓端 TVBox,桌面端与移动端打通的思路。
把播放内核换成 libVLC,移除 IJK / EXO / 迅雷。某些编码格式只有 VLC 能硬解的设备看这个,也是「换内核要动哪里」的现成参考。
上面 Kotlin 版作者的 Android 4.1+ 兼容分支,老设备专用。
自称「基于 TVBoxOSC 二次开发」,加了豆瓣推荐、多源兜底聚合、收藏二次确认。个人项目,可以当「业务层能加什么」的样本看。
三、协议重写与独立实现(13 个)
这一类不 fork 官方源码,用新代码库重写整个壳,只保证能读同一份 TVBox 配置 JSON。架构自由,但要自己补齐协议里的所有边角。
重写派里最成功的一支。Leanback 极简界面,核心是自动跳过失效线路、播放失败自动换源。今天大量衍生版都基于它。
WebHomeTV,基于 FongMi 二次开发,最大特色是支持自定义 HTML 页面。想让首页自己排版,这个思路比改原生布局省事。
TVBox 电脑版/姊妹软件,把功能和生态往桌面端扩展。想在 Windows 上用同一套配置,从这看起。
多协议聚合客户端,除 TVBox 外还接 Jellyfin、Emby、CMS、IPTV、WebDAV、Alist、OpenList。走「聚合」而不是「空壳」的路线,纯本地客户端不扫库。
手机版重写,Kotlin + Jetpack Compose + Media3,UI 是这一批里最现代的,更新很勤。
SwiftUI 原生,覆盖 Apple TV、iPhone、iPad、Mac。Apple 平台上少见的一条路。
支持 TVBox 配置的 Web 化播放器,带直播源、EPG,浏览器里直接跑。
OK 影视,FongMi 分支,做了一些业务增强。2024 年 10 月后没再更新,但源码仍有参考价值。
把播放器做成「插件化媒体容器」,各种数据源以插件形式挂进来。星数不高,但架构是这一堆里最接近长期可维护的。
TVBox 电脑版,纯 Java 影视聚合引擎 + Web 播放器,免安装绿色包,带弹幕和跳过片头片尾。
桌面端跨平台播放器,兼容 FongMi / TVBox 配置格式。Electron 路线。
基于开源 tvbox 及其分支的空壳播放器,小体量实验项目。
「聚影」手机版,APK 只有 2.5MB,无广告免登录。极简路线的个人项目。
四、服务端、接口与工具(15 个)
这一类不碰客户端,跑在服务端或作为接口层。想自建源、做自己的接口,从这里选比改壳省力得多。
把网盘变成源
把 AList 包装成 TVBox 能读的接口,支持播放列表和搜索。自建源这条路上最稳的方案,比折腾爬虫省心。
OpenList / AList / WebDAV 的 TVBox 网关,Go 写的轻量替代品。
写自己的数据接口
猫影视 / TVBox 爬虫合集,现成的站点爬虫参考实现,改改就能接自己的站。
自定义源接口的开发模板,结构最标准的一个,适合照着写第一个 spider。
Python3 + Flask 写的服务端爬虫,不用编译 jar,改规则只要改 Python。
自定义爬虫开发调试项目,强调「调试」——排障比写新源更需要工具。
适配电脑端的猫影视 / TVBox Spider 模板,配 FreeBox 用。
把普通网页站、X5 站点转成 CMS API 数据,伪原创源的经典工具。仓库已归档只读,但思路和代码仍被大量沿用。
装包、巡检与备份
把电脑、NAS 等能跑 Docker 的设备变成盒子的 ADB 安装助手。装 APK 不用再找 U 盘。
直播源检索、测速、优选。接口里的直播线路失效是常态,这类工具比换壳更能解决「卡」。
接口自动化备份,包含抓取、直播源聚合、静态导航页,基于 Python + GitHub Actions。
给 muedsa/TvBox 用的插件示例,提供一个 B 站数据源。写插件而不是改壳,是另一种扩展方式。
上面那个容器的插件 API 定义,想做插件先看接口。
TVBox 等空壳软件的接口分享工具,支持一键复制、收藏、云端更新。
检查 TVBox 源站点可用性的小 App。配置失效时能快速定位是哪一条挂了。
五、已消失与已归档(3 个)
一切分支的源头,猫影视作者公开的那份源码。2022 年 7 月封仓停更,现在仓库本身也访问不到了。要看原版代码,用第 01 条的 j4Uq/TVBoxOSC。
猫影视「复活版」,Flutter 写的全平台客户端,曾经是跨平台方向最受关注的项目。现已无法访问,相关讨论还散落在各个论坛。
俗称「白壳多仓」的版本,搜索结果里常见,实测已不存在。
六、不是 TVBox,但总被一起提(5 个)
这几个常出现在「TVBox 替代品」的推荐里,但它们不读 TVBox 的配置协议,属于独立的 IPTV / 影视客户端。放进来是为了避免你找错方向。
「我的电视」,自建源、界面干净,是国内开源电视播放器里口碑很好的一个。独立协议,不兼容 TVBox 配置。
Material 3 Expressive 风格的 IPTV 播放器,内建 Media3、IJKplayer 和 VLC 三种内核。UI 现代化程度很高。
免费无广告的电视直播 App,Flutter 写的,央视/卫视/地方台,手机与盒子通用。
支持 CatPaw / TVBOX 协议的原生高性能影视客户端。协议兼容但不沿用 TVBox 代码。
红果短剧 TV 端,同时支持本地库(WebDAV/NAS)与类 TVBox 片源。垂直题材方向的一个样本。
七、为什么高星仓库大多不是壳
如果你直接在 GitHub 搜 TVBox 按星排序,排在前面的会是这样的名字:qist/tvbox(12,651★)、liu673cn/bug(10,315★)、gaotianliuyun/gao(8,136★)、jinenge/tvbox(1,201★)。
它们全都不是播放器,而是配置源仓库——里面放的是 JSON 接口地址,每天更新「哪些源还能用」。星数高是因为「复制一个链接就能看」,跟你自己要改代码完全是两件事。
本文刻意没有收录这类仓库,原因有两个:一是它们和「二次开发」没有关系,混进来只会让清单变模糊;二是这类仓库的内容合法性取决于里面的源指向哪里,变动极快,今天收录明天就失效——版权边界与 jar 包安全那篇讲得更清楚。
.json、.txt、README.md,或者一堆 .md 更新日志的,是源仓库;有 app/、build.gradle、settings.gradle 的,才是壳项目。八、这份清单怎么用
只是想装一个用:优先 FongMi(第 11 条)或其衍生版;设备老、Android 版本低,用 Q 版(第 03 条)或 mlabalabala/box(第 05 条)。
想改 UI 或做自己的播放器:起点选 T 版(第 04 条)成本最低,FongMi(第 11 条)架构最现代。具体该动哪一层,看二次开发盘点里的「四层」那一节。
想自建源、不碰客户端:先看 alist-tvbox(第 24 条),再考虑爬虫模板(第 26–31 条)。这条路的长期成本最低,也不涉及客户端分发。
想做跨平台:Swift 走 tvbox-silicon(第 16 条),桌面走 FreeBox(第 13 条),多协议聚合走 Cinetry(第 14 条)。
两点提醒:一是本文所有星数和提交时间都是 2026 年 11 月 6 日的快照,这类项目变动很快,动手前请自己再确认一次仓库还在;二是这些播放器本身是中立空壳,但公开接口源绝大多数指向盗版内容,国内使用涉及侵权,GitHub 上相关仓库也时常被 DMCA 清空——想做长期项目,把接口层做成可插拔,只接自有或授权内容。
相关阅读
- TVBox 二次开发项目盘点:三类分支与主力仓库——本文是清单,那篇讲「怎么选、改哪一层」,两篇配合看。
- TVBox 影视盒子版本大全:主流版本的区别、特色与安装推荐——不关心代码、只想挑一个装,看这篇。
- TVBox 接口是什么?一份配置文件决定了你能看什么
- TVBox 怎么自建接口?用 OpenList 把网盘变成自己的源
- 用 TVBox 有哪些风险?版权边界、jar 包安全与自我保护
- TVBox 教程:从入门到自建的七篇(附完整目录)
甄宝园


