TVBox 这一类软件,GitHub 上写着「Release」的多,真正挂着安装包的少。这篇把 32 个相关项目挨个点开 Release 页看过一遍:25 个项目有正式安装包,7 个只有源码或根本没发过版。29 条代表性下载直链全部做过一次 HTTP 校验,返回 200 才算数。每条给出最新版本号、发版日期、文件名和大小,外加这个版本到底改了什么。
最容易踩的坑,是把「有 Release 标签」当成「有安装包」。实际上好几个高星项目的 Release 页点开,只有一行「源码下载」(zip / tar.gz),那是给开发者用的,普通用户下回去解压出来全是 java 文件。还有一些项目压根没发过版,APK 靠作者自己传到网盘,GitHub 上找不到。
这篇统计的 32 个项目,只算会发安装包的软件类项目——纯放配置文件的仓库(比如 qist/tvbox、gaotianliuyun/gao)和已经 404 的不在此列。其中正式发过安装包的有 25 个,分布在四个平台:
| 平台 | 数量 | 包里是什么 | 典型项目 |
|---|---|---|---|
| 电视盒子 / Android TV | 12 | .apk,分 leanback 与 mobile 两套 | FongMi、WebHomeTV、TVBox Q 版 |
| Windows / macOS / Linux | 9 | .exe / .msi / .dmg / .deb / .jar | FreeBox、OKPlayer、FlyTV |
| 手机(Android / iOS) | 2 | .apk / .ipa | 聚影、红果 TV |
| 插件与运行时 | 2 | .tbp / runtime apk | bilibili-plugin、FongMi 模块包 |
活跃度也值得先说一句——这套生态没有凉。25 个项目里有 8 个在本月发过版,只有 3 个停在 2025 年之前。
这一节是主体。原则是:先在电视或盒子上装壳,再自己配接口。壳本身不含内容,装上打开是空的,这是正常的。
从零重写的 TVBox 兼容客户端,不是官方源码的 fork,但读同一份 JSON 配置。整个生态里最主流的一条线——OK 影视、WebHomeTV、vbox 都是它的分支。电视版(leanback)和手机版(mobile)分开出包,各有 32 位与 64 位。
本版改了什么:改善爬虫生命周期管理(长时间挂机不容易把爬虫进程拖死);改善模块安装的报错提示,装不上时能看出原因;修复磁力与种子文件的选集和续播;修复 YouTube 播放列表解析与选集。升级后要去「设置 → 模块」把 Python、Node.js、QuickJS 三个运行时更新一遍,否则新爬虫跑不起来。
下载:FongMi/Release · 5.8.7
文件:leanback-arm64_v8a.apk 49.0MBleanback-armeabi_v7a.apk 42.7MBmobile-arm64_v8a.apk 48.9MBmobile-armeabi_v7a.apk 42.6MB
基于 FongMi 二次开发,最大的不同是支持自定义 HTML 首页(WebHome),可以把首页做成任意网页形态,还内置了 App Native SDK 和网盘直链能力。代价是包体大——内置了腾讯 X5 内核,一个 APK 一百多兆。
本版改了什么:Exo 播放器遇到压缩音频卡住时自动回退 PCM,改善首次起播与续播恢复,并记住失败的配置减少重复卡顿;修复音频直通开关失效;修复 Exo 播 HDR / 杜比视界视频时 ASS 字幕样式丢失(保留原字体、颜色、特效);修复电视端切换网盘线路的偶发闪退。
下载:webhtv/webhtv · 5.6.0
文件:leanback-arm64 132.9MBleanback-v7a 109.9MBmobile-arm64 132.7MBmobile-v7a 109.8MB
血统最正的一支:直接来自 q215613905/TVBoxOS 的源码,由社区打包仓编译成 APK。兼容性最好,老设备、非标准分辨率的盒子优先选它。一次发 6 个包,java 与 python 是两套内置爬虫环境——java 版跑 jar 爬虫,python 版自带 Python 运行时,能吃 .py 源,包体也大一截。
本版改了什么:修复弹幕加载的偶发问题与拖动进度时的重复加载;搜索兼容 vod_tag:folder 二级页面、历史词按内容动态列宽;线路切换时集数选中光标逻辑优化;选集弹窗与收藏页优化;补了一处 Python 版的网络兼容问题。
下载:j4Uq/TVBoxOSC o0HalfLife0o/TVBoxOSC
文件:java 31.8MBjava32 18.9MBjava64 19.8MBpython 50.2MBpython32 30.1MBpython64 31.5MB
用 Kotlin 重写的 Android TV 客户端,面向 Android 9 以上的盒子与 Android TV,支持电视直播、点播和遥控器操作。代码干净、更新规律,是近两年比较少见「认真在维护」的分支。
本版改了什么:修电视遥控器重进搜索页后光标停在旧关键词开头、退格键删不掉的毛病;重进时把光标放到关键词末尾,正常编辑保留光标与输入法组合状态。版本码 10313,支持应用内 OTA,也公布了 SHA-256 供校验。
下载:ZxxXinI/tvbox · 1.3.13
文件:TVBox-v1.3.13.apk 4.8MBupdate.json
同一个作者给 Android 4.1 以上的古董盒子留的版本。老设备(早年运营商送的机顶盒、安卓 4.4 的电视)基本只有这一个选择。只有 2.9MB,功能是精简过的。
本版改了什么:修设置页遥控器焦点顺序错乱;版本号保持显示 0.0.6 但内部 versionCode 提到 7,让已经装了 code6 的用户能通过 OTA 收到更新,签名沿用原签名。
下载:ZxxXinI/tvbox-android4 · 0.0.6
文件:app-release.apk 2.9MBSHA256SUMS
基于 TVBoxOSC 二次开发的多源聚合客户端,改动主要在界面——换了一套更贴近现在审美的首页样式,多源聚合同一部片子。个人项目,更新很勤。
本版改了什么:维护版本,更新安装包与在线更新清单;启动页和首页隐藏了代理进度提示;支持手机横屏翻转。版本码 206。
下载:TVBox-fashion-UI · 1.7.7
文件:Z.apk 23.8MBupdate.jsonSHA256SUMS.txt
把 TVBox 的播放内核整个换成 libVLC,移除 IJK、EXO 和迅雷内核。用途很明确:原版播不动的冷门格式,用它兜底。另外内置了去插播广告、EPG 节目单和直播源兜底。
本版改了什么:优化播放器与进度条拖动;重编 VLC,支持 m3u8 里伪装成图片的 ts 分片;vod 默认去掉插播广告(视频不完整可在设置里关掉);内置腾讯 X5 修复加载问题;GitHub 不通时回退到内置直播源。
下载:skycn-mi2/TVBox-VLC · 1.4.9
文件:arm64-v8a 74.9MBarmeabi-v7a 68.5MBx86_64 33.0MB
架构完全不同的一个:插件化媒体容器。主程序只负责容器和播放,具体数据源靠独立安装的插件(.tbp 文件)提供,插件可以单独更新、单独卸载。想折腾插件开发的话,这是目前最规整的样板。
本版改了什么:插件 API 版本升到 13,由于依赖接口变更,旧插件可能出现不兼容,要装最新版插件;目录页补回卡片背景色。
下载:muedsa/TvBox · 0.9.2
文件:TvBox-0.9.2-release.apk 23.9MB
注意:这个不是空壳,装完就能看。免费无广告的电视直播 App,央卫视与地方台,手机和盒子通用。省掉了找接口这一步,代价是频道只能用它自带的。
本版改了什么:优化频道切换与起播速度,减少等待;提升长时间观看的播放稳定性;修若干已知问题。分标准包与 armeabi-v7a 包,老盒子装后者。
下载:HTWMedia/HTV · 6.0.7
文件:HTV-6.0.7.apk 20.3MBHTV-6.0.7-armeabi-v7a.apk 10.2MB
Material 3 风格的 IPTV 播放器,内建 Media3,专做直播与节目单。功能密度在这一类里数一数二:多订阅源管理、EPG 解析、语音换台、Web 管理面板、云同步。它管的是 m3u / txt 订阅源,不是 TVBox 的 JSON 接口,别搞混。
本版改了什么:IJK 与 VLC 播放组件改为在线下发,装完要去设置里下载并启用;新增超分与插帧;订阅源支持 FTP / SMB / WebDAV;EPG 解析换成 Rust 内核;修 IJK 起播途中按主页键声音不断、长按快退闪退;ASR 新增 Moonshine v2 模型。
下载:mytv-android · 3.0.0.238(预发布)
文件:arm64-v8a 19.6MBarmeabi-v7a 17.9MBx86_64 19.8MBx5offline 130.1MB
极简的直播软件,可以自定义视频源,安装包只有 5.2MB,启动快。下载量在同类里很高(单这一个包累计四万多次),但已经一年多没更新了,接口如果变了只能自己改源。
本版改了什么:优化频道号显示。此后再无版本。
下载:lizongying/my-tv-0 · 1.3.9.8
文件:my-tv-0_1.3.9.8.apk 5.2MB
多协议聚合播放器,一次装齐:Jellyfin、Emby、CMS 采集接口、IPTV、WebDAV、Alist、OpenList、S 系。适合既有自建媒体库、又想看采集源的人,一个 App 把两边合成一个界面。
本版改了什么:修手机端全屏状态下状态栏显示异常,以及若干已知问题。这个版本同时提供了 Android、iOS(ipa)、Windows、macOS、Linux 五套安装包。
下载:gstory0404/Cinetry · 0.8.4
文件:android.apk 81.2MBios.ipa 28.2MBwindows.exe 41.8MBmacos.dmg 59.9MBlinux.deb 23.0MB
电脑上跑 TVBox,思路和电视不一样:要么做成桌面客户端(FreeBox、OKPlayer、FlyTV),要么做成浏览器里的播放器(Playhub),要么干脆做成服务端,让盒子来连(alist-tvbox)。
TVBox 电脑版里做得最完整的一个。Java 引擎 + 本机 Web 服务,配上同门的「影视-K」手机 App 可以当遥控器用(这个版本要求手机端也升到最新,否则配不上对)。三平台十二个安装包,从 msi 到 AppImage 全都有。
本版改了什么:新增 Spider 脚本动态调试,支持 JS 爬虫热更新调试、实时回显数据、展示调用结果;影视搜索加侧边栏,可按站点筛选结果;站点屏蔽支持全选;修字体显示异常与切换字体无效;修部分媒体链接播放失败;搜索支持中断。注意:arm 架构的 Windows 没有安装包(JavaFX 不提供该平台分发),只能试 x86 免安装版。
下载:kknifer7/FreeBox · 1.8.0
文件:win msi 79.4MBwin.zip 78.6MBmac dmg 82.1/80.9MBdeb 79.1MBrpm 83.0MBAppImage 82.5MB
桌面端播放器,兼容 FongMi / TVBox 配置格式,播放内核用 native-libmpv(不是浏览器套壳),支持导入自己有权使用的片源与网盘直链。Windows 有安装版和便携版,Mac 分 Intel 与 Apple Silicon 两个 dmg。
本版改了什么:修复夸克、百度等网盘原画线路的识别、鉴权预检查与过期链接自动重取,明显提高原画成功率;改进 libmpv 的上一集、下一集、线路回退;进度条拖动与键盘快进快退支持合并连续跳转、卡住自动恢复;修第三方来源请求头含中文时的转发异常。macOS 和 Windows 包未做商业代码签名,首次打开会被系统拦一下。
下载:OKPlayer · 0.1.3
文件:win 便携版 97.1MBwin Setup 97.3MBmac arm64 146.7MBmac x64 151.2MBdeb 97.5MBAppImage 125.9MB
Windows 端的免安装绿色包,解压就能跑。纯 Java 影视聚合引擎 + Web 播放器,支持网盘。适合不想在自己电脑上装东西、或者要塞进 U 盘带走的人。Android 端也在同一个仓库发,但版本落后于 Windows。
本版改了什么:新增「合并全部配置的站点」——把多个配置源里的站点并到一个列表里;同名站点自动加 #2 / #3 后缀,历史和收藏尽量不受影响;每个站点记住自己的配置与 jar,播放时按归属加载,不再串 jar;切换配置或开关合并时自动清理旧爬虫会话。Android 端仍是 1.0.43。
下载:LanLanff/FlyTV · 1.0.53
文件:win.zip 63.1MBandroid-arm64.apk 25.6MB
电脑端影视客户端,主打多源高速检索与原生播放。这条线更新很频繁(已经到 4.x),但 Release 说明写得极简,通常只有一行。安装包偏大(277MB),因为塞了完整运行环境。
本版改了什么:检索结果里源列表的数字显示优化。就这一条——想找详细更新日志的,这里没有。
下载:AinanPlayer · 4.5.0
文件:Setup.exe 276.8MBPortable.zip 202.0MB
把 TVBox 配置搬到浏览器里跑的 Web 播放器。下载的是个 35MB 的 jar,本机有 Java 就能起服务,然后用任意浏览器访问。优点是跨平台——Windows、Mac、Linux、甚至 NAS 都一样;支持直播源、EPG、TVBOX 配置和一键搜索。
本版改了什么:前端整个换成 React + Ant Design,界面现代化;加入 AI 增强——AI 分析搜索结果合并同名影片、按搜索意图推荐、整合多源导演演员简介、清洗播放 URL 去掉无效参数。
下载:HurryBy/Playhub · 1.0.1
文件:playhub-1.0.1.jar 35.4MB(需 Java 环境)
不是播放器,是把 AList 包成 TVBox 能读的接口服务。自建媒体库玩法的核心:网盘挂到 AList,再由它转成 TVBox 的 JSON,盒子上就能直接看网盘里的片子。也支持播放列表与搜索。jar 包 118MB,适合跑在 NAS 或小主机上。
本版改了什么:T4 插件缓存持久化——插件通过 setCache 写入的缓存(站点令牌、搜索结果、验证状态)现在按站点落盘保存,不再因为 Python worker 回收或服务重启丢失;Docker 部署下存在持久卷 /data/t4-cache,升级重启不丢;配置页的 T4 地址改成可点链接。
下载:power721/alist-tvbox · 1.130.0
文件:alist-tvbox-1.0.jar 118MBatv.tar.gz 97MB
上面那个的轻量替代:Go 写的单文件网关,把 OpenList / AList / WebDAV 转成 TVBox 接口。体积只有 3MB 级,七个平台都有包(含 arm 路由器),扔到 OpenWrt 或 NAS 上就能跑。
本版改了什么:依赖升级(esbuild、Go 1.26.4)、替换爬虫构建步骤、前端依赖更新。属于维护性更新,没有功能变化。
下载:openlist-tvbox-gateway · 0.3.3
文件:linux_x86_64 3.4MBlinux_arm64 3.1MBlinux_armv7 3.2MBdarwin / windows 各 2 个
严格说不是播放软件,但是装盒子最省事的一环:把电脑、NAS、软路由变成 ADB 安装助手,用网页给盒子推 APK,不用再找 U 盘和遥控器。
本版改了什么:精简体积。发布的是 .fpk 格式(飞牛 fnOS 的应用包),在应用中心手动安装即可;不想用 fpk 的走 Docker 镜像。
下载:wukongdaily/tvhelper-docker · fpk
文件:tvhelper-1.1.5.fpk 0.1MB
SwiftUI 原生写的 Apple 平台 TVBox 播放器,覆盖 Apple TV、iPhone、iPad 和 Mac。唯一一个不靠 GitHub Releases 发版的——安装包挂在官网,dmg 直链实测可下。想在 Apple TV 上看 TVBox 配置,这是目前最像样的一条路。
本版情况:仓库里只有源码,没有 Release 记录,版本号跟随官网。Mac 版分 Apple Silicon 与 Intel 两个 dmg,Apple TV 与 iOS 走 App Store 或 TestFlight。
手机端这一支人少,因为手机上有现成的视频 App,没必要折腾。但有两个值得记一下——一个主打小,一个主打遥控。
TVBox 手机版,作者明说 100% 由 AI(KIMI-K3)编写。安装包只有 2.5MB——R8 全量压缩的结果,是这份清单里体积最小的一个。无广告、免注册登录,支持苹果 CMS 接口(type0/1)点播与 m3u / txt 直播,装完去「我的 → 设置与数据源」填接口。
本版情况:首个正式版。非直连地址会自动走网页嗅探 + 解析 API 兜底;明暗双主题跟随系统。
下载:csuhan/tvbox · 1.0.0
文件:JuyingTV-v1.0.0.apk 2.5MB
红果短剧的安卓 TV 客户端,Kotlin 原生独立 APK,不是空壳。支持本地库(WebDAV / NAS)与类 TVBox 片源,还带手机遥控电视、内置小爱语音入口。功能密度在短剧类客户端里属于异类——遥控能做到「说句话就跳集」。
本版改了什么:① 修自动更新链路,0.30.8 / 0.30.9 用户必升——本版起双构建,更新通道 APK 实际 minSdk 26 与清单一致,存量用户自动更新全通;另挂 minSdk 21 的包给 Android 5–7 新用户手动装。② 一句话遥控,支持 47 种说法(「快进30秒」「1.5倍速」「跳到片尾」「半小时后关掉」)。③ 说剧名只列结果、不自动播放。④ 电视内置小爱语音入口。⑤ 播放页支持鼠标拖进度条与右键退出。
下载:jycao2/hongguoTV · 0.30.10
文件:-android8.apk 1.9MB-android5.apk 2.2MBSHA256SUMS
这两个不是「软件」,但不少人下载后不知道是什么格式,单独说明。
FongMi 新版把播放内核和脚本运行时拆成了可单独安装的模块:Python 1.1.3、Node.js 1.0.7、QuickJS 1.1.0、mpv 1.1.0、迅雷 1.0.4、BDJ 1.0.1,每个都分 arm64 与 v7a。这些是 apk 但不是拿来点开用的,要在 FongMi 的「设置 → 模块」里装,或者直接在应用内在线下载。
为什么重要:FongMi 5.8.7 的更新说明明确要求升级后去更新这三个运行时(Python / Node.js / QuickJS),否则新爬虫跑不起来。装壳之后播不了,先查模块是不是旧的。
下载:FongMi/Release · module
文件:runtime-python-1.1.3 37.3MBruntime-nodejs-1.0.7 47.6MBruntime-quickjs-1.1.0 2.3MBruntime-mpv-1.1.0 17.2MB
给 muedsa TvBox 用的 B 站数据源插件,装进插件化容器后能直接浏览 B 站内容。发布文件是 .tbp(TvBox Plugin 包),不是 apk,双击装不上,得在 TvBox 的插件管理里导入。
本版改了什么:适配插件 API 13、更新依赖。装之前确认主程序是 0.9.2 以上,否则 API 版本对不上。
下载:muedsa/bilibili-plugin · 0.5.0
文件:bilibili-plugin-0.5.0-release.apk.tbp 0.4MB
这一节是负面清单。下面这些项目同样常被推荐,但点开 Release 页确实没有能装的新包,写清楚免得白找。其中 takagen99/Box 严格说挂过一个包,但那是 2022 年的 alpha,之后三年没再发,按「没有可用版本」处理。
| 项目 | 实际情况 | 怎么办 |
|---|---|---|
| q215613905/TVBoxOS | Q 版源码本体,从不打包 APK | 用第 03 条的打包仓下载 |
| takagen99/Box | Release 里只有一个 v1.0.0-alpha(2022-07,7.4MB),此后再没发过 | 想要 T 版只能自己编译,或找别人编的包 |
| okcaptain/TV | OK 影视源码,2024-10 之后没提交,无 Release | 用它的上游 FongMi(第 01 条) |
| mlabalabala/box | APK 走蓝奏云分发(提取码 6111),GitHub 无 Release | 能装安卓 4.4,但只能从网盘下 |
| akun0o0/vbox | FongMi 的 fork 空壳,只有源码 | 直接用 FongMi |
| kknifer7/TVBoxOS-K | 已被「影视-K」(kknifer7/TV-K)取代,两个仓都没 Release | 只能用 FreeBox 里配套的那一份 |
| springfine/TVBoxOSC-1 | 早期个人改版,只有源码 | 无 |
2019 年之后的盒子基本都是 arm64-v8a,装 64 位包;早年运营商送的盒子、安卓 4.4 老机器才需要 armeabi-v7a。装错了通常不是打不开,而是装完闪退或者播放器加载失败。拿不准就先装 v7a——32 位包在 64 位设备上大多也能跑,反过来不行。
java 版是传统方案,爬虫是 jar 包;python 版内置 Python 运行时,能直接吃 .py 源,包体大 20MB 左右。现在大部分源两种都有,没有特殊需求选 java 版,省空间也少出毛病。
看到这三个后缀别往电视上装。.tbp 是插件包,导入到支持插件的壳里(muedsa TvBox);.fpk 是飞牛 fnOS 的应用包,在 NAS 上装;.jar 要 Java 环境,得在电脑或服务器上跑。
除了 HTV、红果 TV 这类自带内容的,其余都是空壳。安装后要自己配接口:找一份 JSON 配置地址,粘到「设置 → 配置地址」,然后刷新。这一步略过,打开就是白屏。
FongMi 现在把 Python / Node.js / QuickJS 这些运行时拆成了单独安装的模块。主程序升级了但模块没更新,会出现「源加载失败」「播放黑屏」这类看着像源坏了的问题。先查模块版本,再怀疑源。
几个规范的项目已经给了校验值:ZxxXinI 公布 SHA-256、红果 TV 和 TVBox-fashion-UI 挂 SHA256SUMS。certutil -hashfile 文件名 SHA256 对一下,防止下到被人替换过的包。没有校验值的项目,至少确认是从本项目 Release 页下的。
这些客户端本身是中立空壳,不含任何影视内容,代码开源、可自行审查。但社区流传的接口配置绝大多数指向未授权的影视站点,用它看片属于侵权范畴,国内已有多起相关判例。带上「破解版」「去广告版」字样的第三方改包风险更高——可能被塞了后门或挖矿程序,而且拿不到任何更新。自己用、接自有或授权内容(比如第 18 条那种自建媒体库方案),是这个生态里唯一稳的玩法。
只想找个能看的:电视上装 FongMi(第 01 条)或 TVBox Q 版(第 03 条),配一份接口就能用;不想折腾接口的,装 HTV 或 mytv-android,自带源。
老设备:安卓 4.x 用 TVBox Android 4 兼容版(第 05 条);只有 1GB 内存的盒子优先白菜 VLC 版或 my-tv-0,它们包体小、内存占用低。
电脑上看:Windows 首选 FreeBox(第 13 条),功能最全;只想临时看、不想装东西,用 FlyTV 绿色包(第 15 条);Mac 上要精致一点,OKPlayer(第 14 条)或 Yingxia(第 21 条)。
自建:NAS 上跑 alist-tvbox(第 18 条)把网盘变成接口,盒子端随便装个壳指过去。这是唯一不依赖第三方站点的方案。
这一篇是索引。上面每一项都另写了一篇独立的介绍:那个软件是什么来历、具体能干什么、最新版本改了哪些地方、安装包怎么选、装完踩坑怎么排。想细看某一条,直接点进去。
电视端(14 篇)
电脑端(8 篇)
手机端(2 篇)
Apple 平台(1 篇)