甄宝园甄宝园
项目推荐 软件下载 资源聚合 实用教程
全站栏目
网站首页
项目推荐
在线工具库 人工智能库 趣味网站库 办公助手库 下载助手库 影视电视库 系统维护库 软件资源库 学习教育库
软件下载
电脑软件 电视软件 安卓软件 其它软件
资源聚合
直播源专题 打印机专题 TVBox 专题
实用教程
电视教程 电脑教程 手机教程 其它教程
网站地图 标签索引 在线留言
首页/ 资源聚合/ TVBox 专题/ 正文

TVBox GitHub 项目总清单:原版、二次开发与周边全收录

浏览 1372 约 25 分钟

这份清单收录 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 清空——想做长期项目,把接口层做成可插拔,只接自有或授权内容。

合规提示:文中涉及的示例均为公开渠道获取的技术内容,仅用于说明原理与工具用法。请在合法范围内使用,不要传播、售卖或用于商业用途。
TVBox 开源项目 项目清单 影视软件

继续读

下一篇TVBox 二次开发项目盘点:GitHub 上的三类分支与主力仓库

相关推荐

按标签自动匹配
IPTV 直播源完整教程(共 8 篇):M3U 原理、寻源验源与 TVBox/Kodi 配置全解 直播源专题2026-10-02 TVBox 完全指南:版本怎么选、APK 怎么下、接口怎么填,一篇讲透 直播源专题2026-09-18 MinerU:PDF 和扫描件,一键变成能编辑的文字 人工智能库2026-11-02 android-ad-cleaner:安卓手机广告关不掉?电脑连手机批量关闭 其它教程2026-11-02 NuvioTV:自带片源的跨平台开源播放器 影视电视库2026-10-19

© 2026 甄宝园 zby365.com网站地图XML地图电脑版

本站内容均来自网络收集整理,仅供个人学习与交流使用。如本站内容侵犯了您的合法权益,请在线留言与我们联系,侵权类留言不会公开显示,核实后会在第一时间处理或删除。