这份清单收录 46 个与 TVBox 相关的 GitHub 仓库,包括原版源码存档、同源分支、协议重写版、服务端配套工具,以及已经消失的项目。每一条都带地址、语言、星数和最后一次提交时间,全部在 2026 年 11 月 6 日逐个实查过。

它是一份索引,不是评测——每个项目只给一句话定位,不展开分析。想知道哪一类适合你、二次开发该改哪一层,看站内另一篇《TVBox 二次开发项目盘点》。

查之前先记住三件事:① 官方仓库已经 404 了,CatVodTVOfficial/TVBoxOSC 现在打不开;② 星数最高的几个仓库大多是配置源不是壳,别被误导;③ 所有「官方版 APK」都是第三方拿源码自己编译的。

一、原版与源码存档(2 个)

TVBox 的源代码起点是「猫影视」作者停更后公开的那份 Java 工程。官方仓库现在已经访问不了,但代码本身被完整搬运了下来,还在继续被人提交。

01j4Uq/TVBoxOSC无标注 · 18,112★ · 2026-11事实主仓

官方仓库消失后,这份独立重传的源码承接了整个社区。18k 星使它成为 TVBox 生态里关注度最高的仓库,也是绝大多数分支的真正上游。想看「原版长什么样」从这里入手。

02springfine/TVBoxOSC-1Java · 43★ · 2022-07历史快照

2022 年 7 月的原始快照,描述里写着「基于 CatVodTVOfficial/TVBoxOSC 修改」。代码几乎未经改动,适合研究最初的工程结构——但别拿它当工程基础,太旧了。

二、同源分支:fork 官方源码(8 个)

这一类共用同一套 Java 代码底座,改 UI、换播放内核、适配老设备,成本最低。

03q215613905/TVBoxOSJava · 3,012★ · 2026-10Q 版

兼容性最好的一条分支,老盒子和低版本 Android 基本靠它。界面朴素、改动克制,直播回放做得早。社区俗称「Q 版 / 俊版 / 蓝版」。

04takagen99/BoxJava · 3,091★ · 2026-02T 版

官方仓库的 fork,UI 改得最狠,也是这几条线里结构最清晰、最适合拿来做二次开发的起点。仓库描述只有「Experimental」一个词。2026 年 2 月后基本停更。

05mlabalabala/boxJava · 388★ · 2026-03

重做了多源处理逻辑,专门兼容 Android 4.4。库存老盒子、跑分低的电视棒可以试这个。

06ZxxXinI/tvboxKotlin · 261★ · 2026-10

用 Kotlin 重写的 Android TV 版,支持电视直播、点播与遥控器操作,属于「在旧生态里用新语言写一遍」的尝试。

07kknifer7/TVBoxOS-KJava · 102★ · 2025-12

和同作者的 FreeBox 配套使用的安卓端 TVBox,桌面端与移动端打通的思路。

08skycn-mi2/TVBox-VLCJava · 68★ · 2024-07

把播放内核换成 libVLC,移除 IJK / EXO / 迅雷。某些编码格式只有 VLC 能硬解的设备看这个,也是「换内核要动哪里」的现成参考。

09ZxxXinI/tvbox-android4Java · 37★ · 2026-10

上面 Kotlin 版作者的 Android 4.1+ 兼容分支,老设备专用。

10zongchenghuan0318/TVBox-fashion-UIJava · 32★ · 2026-11

自称「基于 TVBoxOSC 二次开发」,加了豆瓣推荐、多源兜底聚合、收藏二次确认。个人项目,可以当「业务层能加什么」的样本看。

TVBox 生态 GitHub 仓库分布统计
46 个仓库的构成,以及播放器/配套项目里的星数排行(2026-11-06 实查)

三、协议重写与独立实现(13 个)

这一类不 fork 官方源码,用新代码库重写整个壳,只保证能读同一份 TVBox 配置 JSON。架构自由,但要自己补齐协议里的所有边角。

11FongMi/TVJava · 10,333★ · 2026-11最活跃

重写派里最成功的一支。Leanback 极简界面,核心是自动跳过失效线路、播放失败自动换源。今天大量衍生版都基于它。

12webhtv/webhtvJava · 1,874★ · 2026-10

WebHomeTV,基于 FongMi 二次开发,最大特色是支持自定义 HTML 页面。想让首页自己排版,这个思路比改原生布局省事。

13kknifer7/FreeBoxJava · 2,129★ · 2026-07

TVBox 电脑版/姊妹软件,把功能和生态往桌面端扩展。想在 Windows 上用同一套配置,从这看起。

14gstory0404/Cinetry全平台 · 3,036★ · 2026-09

多协议聚合客户端,除 TVBox 外还接 Jellyfin、Emby、CMS、IPTV、WebDAV、Alist、OpenList。走「聚合」而不是「空壳」的路线,纯本地客户端不扫库。

15XiaochangXu/AVBoxKotlin · 590★ · 2026-11Compose

手机版重写,Kotlin + Jetpack Compose + Media3,UI 是这一批里最现代的,更新很勤。

16jo32/tvbox-siliconSwift · 376★ · 2026-11

SwiftUI 原生,覆盖 Apple TV、iPhone、iPad、Mac。Apple 平台上少见的一条路。

17HurryBy/PlayhubJava · 89★ · 2026-06

支持 TVBox 配置的 Web 化播放器,带直播源、EPG,浏览器里直接跑。

18okcaptain/TVJava · 83★ · 2024-10停更

OK 影视,FongMi 分支,做了一些业务增强。2024 年 10 月后没再更新,但源码仍有参考价值。

19muedsa/TvBoxKotlin · 69★ · 2026-10插件化

把播放器做成「插件化媒体容器」,各种数据源以插件形式挂进来。星数不高,但架构是这一堆里最接近长期可维护的。

20LanLanff/FlyTVJava · 24★ · 2026-11

TVBox 电脑版,纯 Java 影视聚合引擎 + Web 播放器,免安装绿色包,带弹幕和跳过片头片尾。

21jianbinzhang1987/OKPlayerTypeScript · 17★ · 2026-11

桌面端跨平台播放器,兼容 FongMi / TVBox 配置格式。Electron 路线。

22akun0o0/vboxKotlin · 3★ · 2026-03

基于开源 tvbox 及其分支的空壳播放器,小体量实验项目。

23csuhan/tvboxKotlin · 1★ · 2026-10

「聚影」手机版,APK 只有 2.5MB,无广告免登录。极简路线的个人项目。

四、服务端、接口与工具(15 个)

这一类不碰客户端,跑在服务端或作为接口层。想自建源、做自己的接口,从这里选比改壳省力得多。

把网盘变成源

24power721/alist-tvboxJava · 3,173★ · 2026-11最成熟

把 AList 包装成 TVBox 能读的接口,支持播放列表和搜索。自建源这条路上最稳的方案,比折腾爬虫省心。

25outlook84/openlist-tvbox-gatewayGo · 12★ · 2026-09

OpenList / AList / WebDAV 的 TVBox 网关,Go 写的轻量替代品。

写自己的数据接口

26jadehh/TVSpiderJavaScript · 697★ · 2024-09

猫影视 / TVBox 爬虫合集,现成的站点爬虫参考实现,改改就能接自己的站。

27bizhangjie/CatVodSpiderJava · 542★ · 2025-10

自定义源接口的开发模板,结构最标准的一个,适合照着写第一个 spider。

28sec-an/TV_SpiderPython · 295★ · 2025-08

Python3 + Flask 写的服务端爬虫,不用编译 jar,改规则只要改 Python。

29syzxasdc/CatVodTVSpider1Java · 89★ · 2024-04

自定义爬虫开发调试项目,强调「调试」——排障比写新源更需要工具。

30kknifer7/CatVodSpider-PCJava · 56★ · 2025-11

适配电脑端的猫影视 / TVBox Spider 模板,配 FreeBox 用。

31hjdhnx/dr_pyJavaScript · 779★ · 2024-05已归档

把普通网页站、X5 站点转成 CMS API 数据,伪原创源的经典工具。仓库已归档只读,但思路和代码仍被大量沿用。

装包、巡检与备份

32wukongdaily/tvhelper-dockerShell · 1,087★ · 2026-03

把电脑、NAS 等能跑 Docker 的设备变成盒子的 ADB 安装助手。装 APK 不用再找 U 盘。

33Supprise0901/TVBox_livePython · 1,054★ · 2026-11

直播源检索、测速、优选。接口里的直播线路失效是常态,这类工具比换壳更能解决「卡」。

34lubin776/tvbox-api-backupPython · 416★ · 2026-11

接口自动化备份,包含抓取、直播源聚合、静态导航页,基于 Python + GitHub Actions。

35muedsa/bilibili-pluginKotlin · 8★ · 2026-10

给 muedsa/TvBox 用的插件示例,提供一个 B 站数据源。写插件而不是改壳,是另一种扩展方式。

36muedsa/TvBoxPluginKotlin · 4★ · 2026-10

上面那个容器的插件 API 定义,想做插件先看接口。

37EasyXC/EasyApiKotlin · 2★ · 2026-06

TVBox 等空壳软件的接口分享工具,支持一键复制、收藏、云端更新。

38lyrhub/tvbox-checker-appKotlin · 1★ · 2026-07

检查 TVBox 源站点可用性的小 App。配置失效时能快速定位是哪一条挂了。

五、已消失与已归档(3 个)

这一节是给你避坑的。网上大量教程、博客、公众号文章仍在推荐下面这些仓库,链接点开就是 404。TVBox 生态里仓库消失是常态,看到「官方原版」「官方仓库」这类说法,先自己点一下再说。
39CatVodTVOfficial/TVBoxOSC404 · 2022-07 封仓已消失

一切分支的源头,猫影视作者公开的那份源码。2022 年 7 月封仓停更,现在仓库本身也访问不到了。要看原版代码,用第 01 条的 j4Uq/TVBoxOSC。

40catvod/CatVodOpen404已消失

猫影视「复活版」,Flutter 写的全平台客户端,曾经是跨平台方向最受关注的项目。现已无法访问,相关讨论还散落在各个论坛。

41yjhua2005/TVBoxOS404已消失

俗称「白壳多仓」的版本,搜索结果里常见,实测已不存在。

六、不是 TVBox,但总被一起提(5 个)

这几个常出现在「TVBox 替代品」的推荐里,但它们不读 TVBox 的配置协议,属于独立的 IPTV / 影视客户端。放进来是为了避免你找错方向。

42lizongying/my-tv-0Kotlin · 4,674★ · 2025-05

「我的电视」,自建源、界面干净,是国内开源电视播放器里口碑很好的一个。独立协议,不兼容 TVBox 配置。

43mytv-android/mytv-androidKotlin · 3,012★ · 2026-11

Material 3 Expressive 风格的 IPTV 播放器,内建 Media3、IJKplayer 和 VLC 三种内核。UI 现代化程度很高。

44HTWMedia/HTVDart · 823★ · 2026-11

免费无广告的电视直播 App,Flutter 写的,央视/卫视/地方台,手机与盒子通用。

45Ainanya21/AinanPlayer512★ · 2026-11

支持 CatPaw / TVBOX 协议的原生高性能影视客户端。协议兼容但不沿用 TVBox 代码。

46jycao2/hongguoTVKotlin · 93★ · 2026-11

红果短剧 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 清空——想做长期项目,把接口层做成可插拔,只接自有或授权内容。