tvbox

项目概述

TVBox 是一个面向 Android TV 与电视盒子的影视播放应用，使用 Kotlin、Jetpack Compose 与 Media3 ExoPlayer 构建。应用重点适配遥控器操作，提供影视分类、搜索、详情、m3u8 播放、观看历史、电视直播、平台直播与 OTA 更新。它只提供客户端能力，不内置或托管任何影视内容，需要用户确保所用接口具备合法授权。

遥控器按得顺，点播和直播都在一个壳里。

主要功能

• 电视适配：支持 Leanback 启动器，同时保留普通 Android 入口
• 遥控器交互：方向键、确认键、返回键、菜单键与数字键均有对应操作
• 首页影视列表：默认展示豆瓣热播剧集，支持海报、评分、分页与焦点高亮
• 视频接口管理：内置 32 个资源站，设置页可选择数据源，也可扫码添加 MacCms 自定义接口
• 搜索与详情：关键词搜索最多三条来源并行，结果增量去重，详情页优先显示主来源
• AI 找片：支持文字、应用内语音识别与快捷推荐词，扫码即可配置大模型与密钥
• 直播支持：支持 TVBox 文本与 M3U 直播源、分组切换与自动换线，并支持斗鱼、虎牙、哔哩哔哩、抖音与快手等平台直播
• OTA 更新：启动后检查更新清单，发现新版本可下载 APK 并跳转系统安装器
• 内容过滤：过滤不需要的分类与资源

适用人群

• Android TV 与电视盒子用户
• 习惯用遥控器操作的用户
• 需要点播与直播二合一的用户
• 想让电视具备 AI 找片能力的用户

快速上手

1. 从 Release 下载最新 APK
2. 安装到 Android TV 或电视盒子，也可通过 ADB 安装
3. 打开应用，在设置页选择视频接口数据源
4. 需要新增接口时点击「添加接口」，电视弹出二维码后用手机扫码填写

adb install -r TVBox-v1.3.9.apk

核心优势

• 遥控器友好：数字键直达历史、搜索、直播与设置，操作路径短
• 数据源灵活：内置资源站并可扫码扩展 MacCms 接口
• 点播直播皆备：既支持影视点播，也支持电视与平台直播
• 更新更省心：OTA 更新带完整性校验，安装更放心

系统要求

注意事项

• 请确保使用的影视与直播接口具备合法授权，本项目不内置或托管影视内容
• 平台直播的服务地址在构建时注入，地址变化需重新构建 APK，不要填写本机地址
• AI 找片在手机提交密钥后才会覆盖内置配置，未填写时继续使用默认配置
• OTA 更新清单来自仓库根目录，需与应用版本号匹配才会提示更新