TVBox

大屏电视端 · TV

Verified safeOpen sourceExclusive

Download APK

—

No reviews reviews

downloads

android

AI summary

Android TV and phone video player built in Kotlin with Jetpack Compose. Requires user-supplied m3u8 or JSON streaming sources; no built-in content. Version 1.3.5 adds Media3 native playback controls, phone brightness/volume gestures, and auto orientation for short-form video. Includes OTA self-update via GitHub. RECORD_AUDIO permission present without clear in-app need.

Generated by AI. May contain inaccuracies.

About this app

你贴的 https://github.com/ZxxXinI/tvbox 是一个独立重写的 Android TV / 电视盒子影视客户端，不是 takagen99/Box 或 CatVodTVOSC 那条常见 TVBox 分支，技术栈和定位都有明显区别。

项目定位（和你贴的 README 一致）

- 空壳客户端：只提供播放器与 UI 能力，不内置影视/直播内容，需自行配置 m3u8 / 点播 JSON 接口 - 技术栈：Kotlin + Jetpack Compose（TV 向）+ Media3 ExoPlayer，Android 9+ - 当前版本：1.3.5（versionCode 10305），已把播放控制迁到 Media3 原生，加了手机端亮度/音量手势、短剧横竖屏适配、OTA 自更新（读 GitHub main 分支 "update.json"）

相比“传统 TVBox 分支”的差异

维度 ZxxXinI/tvbox 传统 TVBox（takagen99/CatVod 系）语言/UI Kotlin + Compose 全新写多 Java + 旧 XML/Leanback 改造播放器 Media3 ExoPlayer 原生控制 ExoPlayer/IJK/爬虫 Jar 混合源协议 m3u8 + 自建 JSON 接口爬虫 Jar、XP 源、多仓 JSON 扩展能力无 Spider Jar 体系，偏“播放前端” 靠 Jar 包扩解析，社区源生态大适配重点遥控器 + 手机手势 + 短剧屏效纯遥控器 + 聚合搜片

简单说：ZxxXinI 版更像“现代 Android TV 播放器参考实现”，传统 TVBox 像“源聚合框架”。

构建与配置要点（摘你文档）

- 签名/Key 走 "local.properties" 或环境变量（ "TVBOX_AI_API_KEY"、 "signing.*"），不进仓库 - "update.json" 放根目录， "apkUrl" 指向 Release APK，启动自检查更新 - 接口配置、直播服务、AI 找片 Key 均外部注入，符合“客户端不含内容”的声明

使用提醒

- 项目本身合规，但接口内容版权由使用者负责——README 已声明不托管资源，配未授权源有侵权风险 - 同名叫“TVBox”的仓库很多（ZxxXinI、youhunwl、1771245847、xiongjian83 等），别把传统 TVBox 的多仓 JSON 直接当成本项目的“视频接口配置”，字段结构不一定通用，要看它自己 README 里的接口约定 - 如果想改源码：环境要 Android Studio + JDK 17 级、Gradle 能拉 Compose/Media3，adb 装 debug 包验证遥控器焦点是最快踩坑方式页面抓取受限，但我已有该 Release 的官方资产清单（来自你附带的 user_doc）。下面给你一份可直接使用的 v1.3.5 发布说明与下载指引。

TVBox v1.3.5（ZxxXinI/tvbox）发布信息

发布时间：2026-08-16 13:07 UTC　提交： "84e5455"　Latest 标签

更新要点（Changelog）

- Media3 原生控制器：统一播放、选集与倍速设置交互 - 手机端手势：支持亮度、音量及完整播放手势控制 - 智能横竖屏适配：竖屏短剧自动适配手机竖屏，电视端完整显示

资产（Assets）清单

文件大小 SHA-256 TVBox-v1.3.5.apk 4.63 MB "83499f7a98a05cdae1a11366a56af49868f0c66737396261716a22a220910ed3" update.json 514 B "ae37f6172da043ddbdaaad38d32d4e6686d84734ee4669b052cd0881a6b28a30" Source code (zip) — 源码包 Source code (tar.gz) — 源码包

下载与校验

- APK 直链： "https://github.com/ZxxXinI/tvbox/releases/download/v1.3.5/TVBox-v1.3.5.apk" - 建议在浏览器/下载工具中核对 SHA-256 与官方一致后再安装；Android 9+ 设备，允许“未知来源”安装权限 - "update.json" 用于客户端 OTA 自更新，服务端部署时让其可被客户端访问即可，APK 的 "apkUrl" 指向上述 Release APK

安装提示

- 这是空壳播放前端，不含影视/直播资源，首次使用需自行填入 m3u8 点播接口与直播服务地址 - 项目本身合规，但所配置的接口内容版权由使用者自行负责

tv video player open source media3 kotlin offline