mclhm8182 / tvhome-zh

简体中文 | English
---
# tvhome-zh
把 Android TV / Google TV 换成 **Apple TV（tvOS）风格**桌面的开源项目，**装完就能用，不折腾**。
**本仓库是 Gathin23/tv-vibehack 的衍生分支**，遵循原项目 MIT
许可证，版权归原作者 Gathin 所有（见 LICENSE 与 NOTICE）。**非官方项目**，与原作者
及上游社区无隶属关系。
> 上游现已更名为 **CleanYourTV**（官网 cleanyour.tv），tv-vibehack 的旧链接会重定向过去。
> 上游版本更新更快、功能更多，但设计前提是"你会用 AI 帮你折腾电视"；本仓库解决的是另一件事。
上游的原话是「一个 GitHub 仓库、一个 AI 和十分钟」。它把清理电视的整套方法做成了提示词和脚本，
交给 Claude Code 之类的助手去你家电视上执行——**这套东西需要你愿意折腾**。
本仓库走的是另一条路：**把上游那些"要改配置文件、要重新编译、要推文件"的设置项，全部变成按遥控器就能操作。**
所以它适合这样一类人：
- 想换掉臃肿的广告桌面，但**不想装 JDK、不想编译、不想敲命令行**；
- 家里有老人用电视，希望**开机就是能看的画面**，不需要有人先"配置"一下；
- 中文电视系统，或者干脆想要界面全中文。
如果你要的是上游的全部功能（主题目录、模块卡片、250 KB 瘦身构建等），或者你本来就喜欢自己动手折腾，
**请直接用上游项目**——它更新更快、功能更多。
## 📦 下载
**➜ 下载最新版 tvhome-zh APK** · 仅 **275 KB**，纯 Java，无广告 SDK
前往 Releases 页面 查看全部版本。
> 上游目前仍**不提供编译好的安装包**（其 release 只附源码），需要自行安装 JDK/SDK 并运行
> `launcher/build-and-install.sh` 编译。本仓库**直接提供编译好的 APK**，一条 `adb install` 就能装上
> ——在"不想折腾"这件事上，这是最实际的差别。
## 这不是什么
把电视盒子臃肿的广告桌面换成一个干净的、苹果 tvOS 观感的桌面：
- **纯黑背景 + 底部四格 Dock**（tvOS 那个浅色圆角条的位置）
- **顶部大字显示**当前聚焦的应用名，带一圈取自应用封面的氛围光
- **按「下」键**应用网格从底部滑出
- **一块悬浮玻璃高光**，在图标之间弹性移动，而不是每个格子各画各的边框
- **四个磨砂按钮**：桌面设置、常用、输入源（HDMI / AV / 直播电视）、Wi-Fi / 设置
- **问候语 + 大号细体时钟 + 日期**（Outfit 字体）
- 可选的**时钟屏保**，防止烧屏
**无广告、无账号、无需 root、无需数据线**，纯 ADB 覆盖安装，一条命令可还原。
### 📦 轻量
安装包只有 **275 KB**（R8 裁剪 + 资源压缩的正式构建），比同类的 TV 桌面轻得多——
纯 Java 实现、仅依赖 `recyclerview` 与 `dynamicanimation` 两个轻量 AndroidX 库，
**没有引入 Compose / Glance 等重型框架，也没有内置广告 SDK 或推荐引擎**。
在 2 GB 内存的国产盒子上实测常驻内存约 **107 MB（PSS）**，运行流畅不拖后腿。
对内存吃紧的低配盒子来说，体积小本身就是优势——装它几乎不占空间。
### 中文版实机截图
在国产电视盒子上运行的样子（简体中文界面）：
 对比：原厂广告桌面（左） vs 本项目桌面（右） 
## 和上游的差异
一句话概括：**上游把配置交给文件和命令行，本仓库把配置交到遥控器上。**
### 本仓库独有
| 功能 | 上游 | 本仓库 |
|---|---|---|
| ⭐ **编辑常用应用**（底部 Dock） | 只能改 `config.xml` 再重新编译 | **按遥控器菜单键**打开面板勾选，或**长按**图标置入/移出；改动存在电视本地 |
| 🎨 **壁纸** | 需用 ADB 把 `wallpaper.jpg` 推到电视上 | 面板里一键开启**必应每日壁纸**，或**从电视里选自己的图**；新图自动替换旧图，**空间恒定一张**，不会越攒越多 |
| 🔢 **每行图标数 3–8** | 只能推 `config.json` 或改配置重编译 | 面板里点一下循环切换；首次使用**按屏幕实际宽度自动推荐** |
| 🌓 **Dock 底板自适应** | 固定不透明，亮色壁纸下像一块黑砖 | 有壁纸时自动转为半透明压暗，纯黑背景时保持原样 |
| 🇨🇳 **中文界面** | 已有（`values-zh-rCN`） | 简繁中文齐全，另补齐德/西/法/俄/加泰/泰/阿/波/塞/土，共 13 种语言 |
| ⌨️ **菜单键快捷设置** | 需改配置文件开启，且按键映射因电视而异 | **菜单键直接弹出**玻璃浮层（电视设置/显示/网络/管理应用/常用/桌面设置），可选择在别的应用里也接管 |
| 📦 **提供编译好的 APK** | 不提供二进制，需自行编译 | release 页直接下载（**275 KB** 正式构建），一条命令装上 |
### 本仓库暂缺（上游有，这里没有）
诚实地列出来，你需要的话请用上游：
- 主题目录一键推送（`themes/`）、模块卡片（其他应用可插入磁贴）
- 首启 AOT 预编译（本仓库是 R8 瘦构建，但不做 AOT）
- 桌面上直接切换 HOME 的快捷磁贴、VPN 应用标记、波斯历显示
其余部分（tvOS 观感、玻璃高光、时钟屏保、`config.json` 覆盖机制、去广告脚本、还原脚本等）
均来自上游，遵循原项目 MIT 许可证。
**默认配置保持通用**，不预设任何片商或设备专属设置，适合任意品牌电视盒子。
### ⭐ 编辑常用应用（底部 Dock）
Dock 就是底部那一排常用应用。两个入口，随你喜欢：
- **按遥控器菜单键**（有些遥控器叫「选项」/长按菜单）→ 弹出「常用应用」面板，列出全部已装应用，已固定的带勾，点一下切换；
- **长按任意应用图标** → 直接置入 Dock；Dock 已满时点它会顶替第一个位置。
选择保存在电视本地，**下次开机依然有效**。想清空就在面板里逐个取消勾选。
### 🎨 桌面设置面板
顶栏第一个磨砂按钮，点开后是一块面板，**所有设置都在这里，不用碰任何配置文件**：
- **必应每日壁纸**——开关打开即每天自动换一张（关掉只停止每日更换，当前壁纸会保留）；
- **每行图标数**——点一下在「自动 / 3 / 4 / 5 / 6」之间循环，当前值和来源始终显示在标题下方；
- **从电视中选择图片**——调用系统文件选择器，电视里存的图都能用，自动裁剪适应屏幕；
- **移除壁纸**——恢复纯黑背景。
### 🔧 进阶：换主题 / 推配置（不用重