​

TVBoxOS-Mobile

一个开源免费无广告的TVBox🏅

您是第 位访问者

🤝 招募开发者： 由于工作原因，项目更新可能不及时。如果你对 TVBox 感兴趣，愿意一起维护和改进这个项目，非常欢迎加入我们的大家庭！无论是提 PR、修 Bug、优化代码还是贡献接口源，任何形式的参与都非常感谢。感兴趣的话可以直接 Fork 项目提交 Pull Request，或者通过 Issue 联系我，一起让这个项目变得更好～

🛠 协作开发指南

本项目使用 GitHub Actions 自动构建和发布，代码合并后即可自动触发构建和 Release，无需手动操作。

参与方式

1. Fork 本仓库 → 在你自己 Fork 的仓库中进行开发
2. 提交 Pull Request → 开发完成后向 main 分支提交 PR
3. 代码审查合并 → 维护者 Review 通过后合并到主分支

自动构建流程

触发条件	行为
推送代码到 main 分支	自动构建 Debug APK，上传到 Artifacts（保留 14 天）
PR 提交	自动构建 Debug APK，用于验证代码是否正常编译
推送 v* 格式的 Tag（如 v2.1.27）	自动构建签名 APK → 创建 GitHub Release → 同步更新 update.json 和 README

如何发布新版本

发布 Release 只需两步：

1. 更新版本号：修改 app/build.gradle 中的 versionCode 和 versionName

   versionCode 237
   versionName '2.1.27'
   

2. 推送 Tag 触发发布：

   git tag v2.1.27
   git push origin v2.1.27

   ⚠️ Tag 版本号必须与 app/build.gradle 中的 versionName 完全一致，否则构建会失败。

推送 Tag 后，GitHub Actions 会自动执行以下操作：

• 使用固定签名密钥构建 Release APK
• 将 APK 和 update.json 上传到 GitHub Releases
• 自动更新 README 中的下载链接和更新记录
• 推送更新后的 update.json 和 README 回 main 分支

注意事项

• PR 合并后会触发普通构建验证，但不会自动发布 Release —— 只有推送 Tag 才会走发布流程

📖介绍

• 本仓库聚合了APP、解析源、直播源等项目，总之你要的一个仓库全搞定(拉到👇有福利)

推荐视频源仓库

https://github.com/gaotianliuyun/gao

https://github.com/yoursmile66/TVBox/

https://github.com/xyq254245/xyqonlinerule/

https://github.com/UndCover/PyramidStore/

📲软件合集（软件安装）

TVBox for Android

• TVbox-Mobile：kukuqi666/TVBoxOS-Mobile

🎁福利18+

• R18: R18

𝟭. 更新记录

• 2026/07/26 TVBox Mobile v2.1.26： 全局壁纸界面改为半透明效果；点播源、直播源和壁纸支持独立入口及独立导入，保留原有链接导入和本地文件导入逻辑；修复壁纸历史配置缺失导致 GitHub Actions 构建失败的问题。

• 2026/07/26 TVBox Mobile v2.1.25： 全局壁纸系统重写——新建 WallpaperManager 管理器实现壁纸本地缓存和全局生效；壁纸弹窗改为三标签页底部面板（内置壁纸 / 订阅壁纸 / 在线壁纸），带实时预览区；所有 Activity 通过 BaseActivity 统一应用壁纸，不再仅限首页。

• 2026/07/25 TVBox Mobile v2.1.24： 同步发布 Android APK、应用内更新清单和下载链接。

• 2026/07/25 TVBox Mobile v2.1.23： 更新检查与下载全部走 gh.xxooo.cf 加速，去掉直连 GitHub 回退；新增第二加速镜像做备选，国内更新更快更稳。

• 2026/07/25 TVBox Mobile v2.1.23： 新增壁纸切换功能，「我的」页面入口可选择 6 套内置渐变壁纸、订阅源配置中的壁纸 URL 以及随机在线壁纸；首页背景即时生效。

• 2026/07/24 TVBox Mobile v2.1.20： 优化手机与平板展示：平板使用原生 dp 密度，首页、推荐、收藏和历史记录根据屏幕宽度自动切换为 4 至 6 列；旋转屏幕后立即重排。我的、订阅、本地视频与详情页在大屏居中显示，避免内容过宽。

• 2026/07/24 TVBox Mobile v2.1.18： 修复 Android 13 及以上本地视频媒体权限，恢复本地视频扫描并显示空列表提示；本地订阅导入改用系统文件选择器，支持持久访问 content:// 文件并缓存配置；移除已下线的肥猫、南风内置订阅。

• 2026/07/23 TVBox Mobile v2.1.17： 应用内检查更新和 APK 下载优先使用 GitHub 加速地址，失败时自动回退直连；新增第二个在线订阅源和 R18 内置订阅配置；发布流程同步校验版本号、tag、update.json、README 下载链接及更新记录。

• 2026/07/22 TVBox Mobile v2.1.16： 修复软件内更新清单未能同步到主分支的问题；发布流程在遇到并发提交时会自动 rebase 后重试推送，确保 Release APK 和在线更新提示保持一致。

• 2026/07/22 TVBox Mobile v2.1.15： 新增肥猫、OK佬、南风三份 APK 内置订阅配置，无需下载配置文件即可选择加载；保留饭太硬在线默认源，以及原有本地文件和链接导入功能。清理 tvbox 目录中 67 份格式损坏、片段式或不兼容的配置文件，保留 45 份可直接识别的配置。

• 2026/07/22 TVBox Mobile v2.1.14： 软件内更新下载新增进度条、百分比和文件大小提示；发布流程改为固定签名密钥配置，避免后续覆盖安装出现签名冲突。

• 2026/07/22 TVBox Mobile v2.1.13： 订阅管理新增清理功能，合并重复地址并删除格式错误或返回空内容的导入订阅；内置、当前使用及网络异常订阅会保留。关于页更新检查改用发布清单，避免 GitHub API 限流导致检查失败。

• 2026/07/22 TVBox Mobile v2.1.12： 关于页升级为应用信息卡片；首页、直播、订阅、我的统一为四项底部导航；直播和订阅入口可直接切换。

• 2026/07/22 TVBox Mobile v2.1.11： 重新发布直播底部导航兼容版本，修复直播页面接入底部导航后的编译问题。

• 2026/07/22 TVBox Mobile v2.1.10： 修复直播页面接入底部导航后的编译问题，完成版本升级。

• 2026/07/22 TVBox Mobile v2.1.9： 统一底部导航的页面绑定和视图类型，修复首页、直播、订阅之间切换时的导航兼容问题。

• 2026/07/22 TVBox Mobile v2.1.8： 新增应用内检查更新功能，可从关于页面检查 GitHub Release 并下载安装新版本。

• 2026/07/22 TVBox Mobile v2.1.7： 增强直播播放列表兼容性，支持更多常见直播源格式和分组写法。

• 2026/07/22 TVBox Mobile v2.1.6： 修复主导航导入应用资源的问题，确保直播和订阅页面可以正确加载。

• 2026/07/22 TVBox Mobile v2.1.5： 调整直播源提示内容，提升对兼容直播源格式的识别和使用体验。

• 2026/07/22 TVBox Mobile v2.1.4： 新增直播和订阅底部导航入口，首页、直播、订阅和我的页面可以直接切换。

• 2026/07/22 TVBox Mobile v2.1.3： 修复内容：选择弹窗的选中位置会限制在有效范围内，空列表不再滚动，延迟滚动前再次验证列表状态，解决 Invalid target position 崩溃。

• 2026/07/22 TVBox Mobile v2.1.2： 更新 Android 构建与发布流程；Release APK 文件名改为 TVBox-Mobile-v2.1.2.apk；内置订阅始终保留，导入订阅可删除，当前使用中的订阅不可删除。

• 2026/07/22 TVBox Mobile v2.1.1： 建立 GitHub Actions 自动构建和 Release 发布流程，支持自动生成 Android APK 并上传到 GitHub Releases。

• 2025/03/10 更新接口： 更新一波tvbox和影视仓接口

• 2025/02/14 更新影视软件： 【小飞电视】，数百频道，非常高清，8K超清, 换台超快，无卡顿,复刻肥羊,三网通用

• 2025/02/06 更新影视软件： OK影视pro电视版，也是比较经典的一款了

• 2025/02/02 更新10+接口： 更新十多款好用的接口，看直播追剧不愁，部分还是很好用的

• 2025/01/27 更新多条接口： 测试多条好用影视接口，基本所有接口都内置了可以看电视的直播源，直接使用即可，过年和亲人一起看电影/电视剧/小品

• 2025/01/26 更新软件： 又好久没更了，今天更新一款完全不卡的影视软件，好用的很，最后提前祝大家新年快乐呐！

• 2025/01/12 更新软件： 【频道多多】测试的时候很流畅呐 各类频道不卡顿

𝟮. 写在前面

🍀 本项目致力于优秀的接口 · 优质稳定的直播源 · 相关好用软件和网站的搜集整理。以上全部免费分享给各位交流学习，如果各位有什么好用的也可以贡献一下

🌸 在上学，本文档不定时更新，文档分享的大部分接口和软件都经过本人亲自测试，首发更新服务群中粉丝

🌺 PS：接口为各大佬维护，时效性不确定，仅本人学业之余网络搜集分享，希望能帮到各位

🧊 两个实用的𝐆𝐢𝐭𝐡𝐮𝐛脚本

• 地址：𝐆𝐢𝐭𝐡𝐮𝐛增强 · 高速下载

• 地址：𝐆𝐢𝐭𝐡𝐮𝐛中文化界面 · 部分菜单及内容高速下载

🧊 𝐆𝐢𝐭𝐡𝐮𝐛加速访问开源项目

• 地址：𝐖𝐚𝐭𝐭𝐓𝐨𝐨𝐥𝐤𝐢𝐭 · 原名𝐒𝐭𝐞𝐚𝐦++

3. 想做自己的接口？

这里只针对没有自己服务器的宝子们，下面是一些常见的开源仓库

• 地址：𝐓𝐫𝐮𝐬𝐭𝐢𝐞: 𝐆𝐢𝐭 𝐰𝐢𝐭𝐡 𝐭𝐫𝐮𝐬𝐭𝐢𝐞 · 一款极易搭建的自助𝐆𝐢𝐭服务

• 地址：𝐆𝐢𝐭𝐞𝐞：国内常用的代码托管平台

• 地址：𝐆𝐢𝐭𝐋𝐚𝐛：𝐀𝐥驱动的𝐃𝐞𝐯𝐒𝐞𝐜𝐎𝐩𝐬平台

• 地址：𝐆𝐢𝐭𝐞𝐚：轻量级的自托管𝐆𝐢𝐭服务

• 地址：𝐆𝐢𝐭𝐇𝐮𝐛：全球最大的开源社区和代码托管平台

特别注意：仓库名不要以"𝐣𝐢𝐞𝐤𝐨𝐮"、"𝐭𝐯𝐛𝐨𝐱"、"𝐛𝐨𝐱"等敏感字眼命名，这样有可能会被"删除仓库"、"封禁账号"等，最好把仓库体积弄大一点，加点杂七杂八的东西进去，这样打造一个属于你的自用接口是没问题的

4. 仓库接口访问加速

在𝐠𝐢𝐭𝐡𝐮𝐛上做的接口访问的速度太慢了怎么办？接口有时都加载不出来？别急！用下面几个可用的加速站

• 地址：𝐉𝐒𝐃𝐄𝐋𝐈𝐕𝐑 · 用于开源项目的快速免费𝐂𝐃𝐍

• 地址：𝐆𝐢𝐭𝐇𝐮𝐛 文件加速

5. 缩短链接网址

显示接口访问数据，包含用户访问量、访问机型、地理分布、浏览器等数据一应俱全，精准分析你的接口用户

• 地址：𝐒𝐡𝐨𝐫𝐭.𝐢𝐨 · 让品牌化链接更加简单 个性化且便于分享

• 地址：缩我短链接 · 老牌免费短链接工具:免费用是真的，不过会给你的链接访问不定时弹出一次广告，我觉得恶心

• 地址：六度短网址 · 支持秒级实时统计的短链接！防封防屏蔽的短网址！

• 地址：𝐔𝐑𝐋𝐂短网址 · 专业社群营销、短信营销、互联网推广工具

6. 随机精美壁纸

想给盒子软件换张唯美好看的背景壁纸？看下面几个网站就对了

• 地址：必应随机壁纸

• 地址：Picsum 随机图片

• 地址：DMoe 随机壁纸

• 地址：BTSTU 美女壁纸

• 地址：BTSTU 随机壁纸

• 地址：CatVod 图片资源

🫶使用说明

• 所有源均收集于互联网，仅供测试研究使用，不得商用；
• 本项目不存储任何的流媒体内容，所有的法律责任与后果应由使用者自行承担；
• 您可以Fork本项目，但引用本项目内容到其他仓库的情况，务必要遵守开源协议.