tvhome-zh v1.4 · 275 KB 正式包 + 菜单键快捷设置 + Home 回顶

tvhome-zh v1.4

Apple TV 风格电视桌面 —— 装完就能用，所有设置都在遥控器上。

Gathin23/cleanyourtv（原 tv-vibehack，MIT © 2026 Gathin）的非官方衍生版本。
一句话：上游把配置交给文件和命令行，本版把配置交给遥控器。

新增

📦 安装包 275 KB	上一版 1.6 MB，这次换成 R8 裁剪 + 资源压缩的正式构建，功能完全一样	闲鱼上好传、下载快，用户不用等
⌨️ 菜单键弹出快捷设置	按遥控器的菜单/设置键直接弹出一块玻璃浮层：电视设置、显示与画面、网络、管理应用、常用应用、桌面设置，浮在当前画面之上，背后继续播放	原来的桌面按钮在别的应用里够不着，现在一键就够得着
🏠 Home 键真的会回顶	从任何应用回到桌面都停在第一行第一格；已经在桌面上再按 Home 也一样	以前按 Home 只是闪一下，原因是系统把 Home 键吞掉了
🔢 每行图标数 3–8	5 列以上磁贴不再挤在一起：磁贴宽度按"每格有多宽"算，聚焦放大也不会压到邻居	1080p 电视上 6 列约 134dp、8 列约 98dp
🧹 面板换成紧凑玻璃样式	桌面设置与常用应用两个面板去掉标题和"关闭"按钮，行高 56→42/52dp，聚焦时整行白色胶囊 + 文字反色，宽度按内容自适应	和输入源菜单是同一套视觉，不再像两个世界

其他

• 输入源兜底：小米等国产 ROM 不把 HDMI 口报给系统时，桌面不再只弹"此电视不支持"就走，而是（若该机有）直接打开电视自己的选源界面；实在没有就照实提示，不给假入口
• 修了一处聚焦反色失效：两行文字的面板行要逐层传递父视图状态，否则整行变白而字还是白的
• 版本号对齐发布号（电视上"应用信息"里看到的和 release 页一致）

与上游的差异

本版独有：上表五项 + 直接提供编译好的 APK（上游不提供二进制）。上表的"菜单键快捷设置"在上游需要改配置文件才开启，且不同电视的按键映射要自己试。
本版暂缺：主题目录一键推送、模块卡片、首启 AOT 预编译、桌面切换磁贴、VPN 标记、波斯历 —— 需要这些请用上游。
完整对照见 README。

安装 / 升级

adb connect <电视IP>:5555
adb install -r tvhome-zh.apk
adb shell cmd package set-home-activity com.gathin.tvhome/.MainActivity

• 新用户：直接下载 tvhome-zh.apk 安装即可，不需要先装别的版本。
• 从 v1.3.0 升级：直接覆盖安装，设置和壁纸都保留。
• 从 v1.2.0 及更早升级：需要先卸载一次（那几个版本换过签名密钥，直接覆盖会报 INSTALL_FAILED_UPDATE_INCOMPATIBLE），卸载后 Dock 和壁纸重设一次即可。
• 最低 Android 8.0。若电视提示安装失败，多半是厂商固件拒绝第三方桌面，见 README「设备兼容性」。

想让 Home 键回顶 / 在别的应用里用菜单键

这两项由一个无障碍服务实现（系统在桌面已打开时会吞掉 Home 键，只有服务能截获）：
设置 → 无障碍 → 已下载的服务 → 「Home 键回顶」→ 打开。不开启也能正常当桌面用，只是这两条不生效。

---

English

An Apple TV-style home screen for Android TV — install it and it just works; every setting lives on the remote.

An unofficial derivative of Gathin23/cleanyourtv (MIT © 2026 Gathin).
In one line: upstream hands configuration to files and the command line; this release hands it to the remote control.

New

📦 275 KB package	1.6 MB before, now an R8-minified, resource-shrunk release build with exactly the same features	quicker to sell, quicker to download
⌨️ Quick settings on the Menu key	the remote's Menu/Settings button opens a glass panel over whatever is on screen: TV settings, display, network, apps, favourites, desktop settings	the buttons on the desk cannot reach other apps; this key can
🏠 Home really goes back to the top	coming back from any app lands on the first row, first tile, and so does pressing Home while already on the desk	it used to only flash: Android swallows the Home key there
🔢 3–8 icons per row	tiles are sized from the cell they live in, so 5 columns and up no longer touch or overlap	about 134dp at 6 columns, 98dp at 8 on a 1080p TV
🧹 Compact glass panels	the desktop-settings and favourites panels lose their title and close button, rows drop from 56 to 42/52dp, the focused row is a solid white pill with inverted text, and the width follows the content	they finally match the Inputs menu instead of looking like a different app

Also

• Input-source fallback: on ROMs that do not report their HDMI ports (Xiaomi and others), the desk no longer just says "not supported" — it opens the TV's own source panel when there is one, and says so plainly when there is none
• Fixed a focus bug: a panel row with two lines of text needs the parent state passed down every level, or the row turns white while the text stays white
• The version number now matches the release (what "App info" shows on the TV agrees with the release page)

Differences from upstream

Only here: the five rows above plus a compiled APK (upstream ships no binaries). Upstream's quick settings need a config change to enable and per-TV key mapping guesswork; here the Menu button just works.
Not here: theme folder pushing, module cards, the first-run AOT profile, the home-switch tile, the VPN badge, the Jalali calendar — use upstream for those.
The full comparison is in the README.

Install / upgrade

adb connect <TV-IP>:5555
adb install -r tvhome-zh.apk
adb shell cmd package set-home-activity com.gathin.tvhome/.MainActivity

• New users: download tvhome-zh.apk and install it. No other version needed first.
• From v1.3.0: install straight over the top; your dock and wallpaper stay.
• From v1.2.0 or older: uninstall once first (those releases used a different signing key, so an in-place install fails with INSTALL_FAILED_UPDATE_INCOMPATIBLE), then install; set your dock and wallpaper again.
• Android 8.0 minimum. If the TV refuses to install it, that is usually vendor firmware refusing third-party launchers — see "Device compatibility" in the README.

Want Home-to-top, or the Menu key inside other apps?

Both need one accessibility service, because Android swallows the Home key when the desk is already in
front: Settings → Accessibility → Downloaded services → "Home button" → turn it on. The launcher
works fine without it; those two simply do not happen.

MIT · Original project © 2026 Gathin · This fork © 2026 mclhm8182 · Unofficial derivative

tvhome-zh v1.3 · 面板贴按钮 + Home 回顶 + 13 语言

tvhome-zh v1.3

Apple TV 风格电视桌面 —— 装完就能用，所有设置都在遥控器上。

Gathin23/tv-vibehack（MIT © 2026 Gathin）的非官方衍生版本。
一句话：上游把配置交给文件和命令行，本版把配置交给遥控器。

新增

📌 面板贴着按钮弹出	「桌面 / 常用 / 壁纸」三个面板改为紧贴按钮下缘弹出、左缘对齐，不再随手飘在屏幕中间
⌂ Home 键回顶	在图标网格里按 Home 回到第一行第一格，而不是重开或停在原处。发标准 Home 键的遥控器开箱即用；少数把 Home 发成 KEYCODE_ALL_APPS 的遥控器（部分小米）需在「无障碍」里打开「Home 键回顶」一次
🖼️ 换壁纸不再崩	4K 以上大图会先按屏幕尺寸降采样再解码，拒绝超规格图片并兜住 OOM。1.6 MB 的桌面换大图更稳
⬆️ 「上」键回到本行顶部	从第 5 行按上键回到第 1 行，而不是每按一次退一整屏
🇹🇼 繁体中文	按港台用词写：桌布（不是「壁纸」）、桌面設定、圖示、網路。另新增阿拉伯、波兰、塞尔维亚（拉丁）、土耳其语，共 13 种语言

其他

• 聚焦高亮的圆角修正，不再多一圈内边距
• 小米电视：标准 Settings intent 无响应时，自动回退打开 com.xiaomi.mitv.settings
• 安装包内的版本号已对齐发布号（1.3.0），在电视上「应用信息」里看到的和 release 对得上

与上游的差异

本版独有：上表五项 + 直接提供编译好的 APK（上游不提供二进制，仍需自行编译安装）。
本版暂缺：主题目录、模块卡片、250 KB 瘦身构建、AOT 预编译、桌面切换磁贴、VPN 标记、波斯历 —— 需要这些请用上游。
完整对照见 README。

安装 / 升级

adb connect <电视IP>:5555
adb install -r tvhome-zh-debug.apk
adb shell cmd package set-home-activity com.gathin.tvhome/.MainActivity

⚠️ 从 v1.2.0 升级需要先卸载一次：本版换了 debug 签名密钥，直接覆盖会报
INSTALL_FAILED_UPDATE_INCOMPATIBLE。卸载旧版再装，Dock 和壁纸重设一次即可。
v1.3.0 往后都能直接覆盖升级，不会再遇到这个问题。

也可以直接在电视上点 APK 安装，见 README「安装」。

---

English

An Apple TV-style home screen for Android TV — install it and it just works; every setting lives on the remote.

An unofficial derivative of Gathin23/tv-vibehack (MIT © 2026 Gathin).
In one line: upstream hands configuration to files and the command line; this release hands it to the remote control.

New

📌 Panels open against their button	The Desktop / Dock / Wallpaper panels now open along the bottom edge of the button they belong to, left edges aligned, instead of floating in the middle of the screen
⌂ Home returns to the top	Press Home in the icon grid to land on the first row, first tile. Remotes that send a normal Home key work out of the box; the few that send KEYCODE_ALL_APPS instead (some Xiaomi remotes) need "Home key to top" enabled once under Accessibility
🖼️ Big wallpapers no longer crash	Images above 4K are subsampled to the screen before decoding, oversized ones are rejected, and OOM is caught. A 1.6 MB launcher can now survive a 4K wallpaper
⬆️ Up goes to the top of the row	From row 5, Up takes you to row 1 instead of scrolling back one screen at a time
🇹🇼 Traditional Chinese	Written the way it is actually written there: 桌布 (not 壁纸), 桌面設定, 圖示, 網路. Arabic, Polish, Serbian (Latin) and Turkish are new too — thirteen languages in total

Also

• The focus highlight's corner radius is fixed; it no longer carries an extra inset
• On Xiaomi TVs, when the standard Settings intent is ignored the launcher falls back to com.xiaomi.mitv.settings
• The version inside the APK now matches the release number (1.3.0), so "App info" on the TV agrees with the release page

Differences from upstream

Only here: the five features above plus a compiled APK (upstream ships no binaries; you still build it yourself).
Not here: theme folders, module cards, the ~250 KB shrunk build, AOT precompilation, the home-switch tile, the VPN badge, the Jalali calendar — use upstream for those.
The full comparison is in the README.

Install / upgrade

adb connect <TV-IP>:5555
adb install -r tvhome-zh-debug.apk
adb shell cmd package set-home-activity com.gathin.tvhome/.MainActivity

⚠️ Upgrading from v1.2.0 needs one uninstall first: this release uses a new debug signing key, so
installing over v1.2.0 fails with INSTALL_FAILED_UPDATE_INCOMPATIBLE. Uninstall, then install, and set your
dock and wallpaper once more. Every release from v1.3.0 onwards upgrades in place.

You can also install the APK straight from the TV — see "Installing" in the README.

MIT · Original project © 2026 Gathin · This fork © 2026 mclhm8182 · Unofficial derivative

tvhome-zh v1.2 · 所有设置都在遥控器上

tvhome-zh v1.2

Apple TV 风格电视桌面 —— 装完就能用，所有设置都在遥控器上。

Gathin23/tv-vibehack（MIT © 2026 Gathin）的非官方衍生版本。
一句话：上游把配置交给文件和命令行，本版把配置交给遥控器。

新增

⭐ Dock 可编辑	菜单键弹面板勾选常用应用，长按图标也能置入/移出。存在电视本地，重启有效。上游只能改配置重编译
🎨 桌面设置面板	顶栏第一个按钮：必应每日壁纸 / 每行图标数 / 从电视选图 / 移除壁纸，全程不用碰配置文件
🔢 每行图标数 3–6	面板里点一下循环；首次按屏幕实际宽度自动推荐
🌓 Dock 底板自适应	有壁纸时转半透明压暗，纯黑背景保持原样（上游固定不透明，亮色壁纸上像块黑砖）

其他

• 8 种语言：中 / 英 / 德 / 西 / 法 / 俄 / 加泰 / 泰，自动跟随系统语言；Android 13+ 可单独指定
• 面板聚焦改为柔和光晕，修复两侧被裁剪
• 关必应开关只停止每日更换、不再误删当前壁纸；移除壁纸立即生效

与上游的差异

本版独有：上表四项 + 直接提供编译好的 APK（上游不提供二进制，仍需自行编译安装）。
本版暂缺：主题目录、模块卡片、250 KB 瘦身构建、AOT 预编译、桌面切换磁贴、VPN 标记、波斯历 —— 需要这些请用上游。
完整对照见 README。

安装 / 升级

adb connect <电视IP>:5555
adb install -r tvhome-zh-debug.apk
adb shell cmd package set-home-activity com.gathin.tvhome/.MainActivity

从 v1.1 覆盖安装即可，已设置的 Dock 和壁纸都保留。也可以直接在电视上装 APK，见 README「安装」。

---

English

An Apple TV-style home screen for Android TV — install it and it just works; every setting lives on the remote.

An unofficial derivative of Gathin23/tv-vibehack (MIT © 2026 Gathin).
In one line: upstream hands configuration to files and the command line; this release hands it to the remote control.

New

⭐ Editable dock	The Menu key opens a checklist; a long-press pins or unpins a tile. Stored on the TV, survives reboot. Upstream: edit a config file and recompile
🎨 Desktop settings panel	First pill on the top bar: Bing daily wallpaper / icons per row / pick a picture on the TV / remove wallpaper — no config files involved
🔢 Icons per row, 3–6	Tap to cycle in the panel; the first run recommends a value from the actual screen width
🌓 Adaptive dock band	Translucent over a wallpaper, unchanged on black. Upstream keeps it opaque, which reads as a black slab on a bright picture

Also

• Eight languages: Chinese / English / German / Spanish / French / Russian / Catalan / Thai, following the TV automatically, and settable per-app on Android 13+
• Panel rows now use a soft glow instead of a solid white highlight, and no longer clip it at the sides
• Switching the daily wallpaper off no longer deletes the current wallpaper; removing it takes effect immediately

Differences from upstream

Only here: the four features above plus a compiled APK (upstream ships no binaries; you still build it yourself).
Not here: theme folders, module cards, the ~250 KB shrunk build, AOT precompilation, the home-switch tile, the VPN badge, the Jalali calendar — use upstream for those.
The full comparison is in the README.

Install / upgrade

adb connect <TV-IP>:5555
adb install -r tvhome-zh-debug.apk
adb shell cmd package set-home-activity com.gathin.tvhome/.MainActivity

Overwriting v1.1 keeps your dock and wallpaper. You can also install the APK directly on the TV — see "Installing" in the README.

MIT · Original project © 2026 Gathin · This fork © 2026 mclhm8182 · Unofficial derivative

tvhome-zh v1.1.0 · 常用应用可编辑 + 主题机制

tvhome-zh v1.1.0

tv-vibehack 的简体中文本地化版本 —— 把 Android TV / Google TV 换成 Apple TV（tvOS）风格桌面。

本版本是 Gathin23/tv-vibehack（MIT © 2026 Gathin）的中文衍生版。

✨ 本版新增

⭐ 常用应用（Dock）现在可以在电视上直接编辑

v1.0.0 里底部常用应用是写死在配置文件里的，想换必须改文件重新编译。v1.1 彻底解决了这个问题——现在你在沙发上就能改：

• 按遥控器菜单键（有些遥控器叫「选项」）→ 弹出「常用应用」面板，列出全部已装应用，已固定的带勾，点一下切换；
• 长按任意应用图标 → 直接置入 Dock；Dock 已满时点它会顶替第一个位置；
• 顶部也新增了一个「常用」磨砂按钮，点开是同一个面板。

选择保存在电视本地，下次开机依然有效，不用改文件、不用重新编译。

🎨 移植上游主题覆盖机制（换主题/壁纸不用重编译）

新增 Config.java：桌面启动时自动读取电视上的

/sdcard/Android/data/com.gathin.tvhome/files/

• wallpaper.jpg → 成为桌面背景（删掉即恢复纯黑）；
• config.json → 覆盖内置配置（Dock、列数、背景色等）。

配套一键换壁纸脚本 tools/set-wallpaper.sh：

./tools/set-wallpaper.sh <电视IP> <图片路径>

📋 沿用 v1.0.0 的特性

• 🇨🇳 完整简体中文（问候语、输入源、设置、Wi-Fi 状态、错误提示、中文日期）
• 📦 轻量：安装包仅 1.6MB，纯 Java，仅依赖 recyclerview + dynamicanimation，无 Compose/Glance、无广告 SDK。2GB 内存盒子实测常驻约 107MB
• 🎯 通用默认配置，适合任意品牌电视盒子
• 📱 兼容 Android 11：targetSdk 29，不受包可见性限制，能枚举全部应用

安装 / 升级

# 电视开启「USB 调试」后
adb connect <电视IP>:5555
adb install -r tvhome-zh-debug.apk
adb shell pm grant com.gathin.tvhome android.permission.ACCESS_FINE_LOCATION
adb shell cmd package set-home-activity com.gathin.tvhome/.MainActivity

从 v1.0.0 升级直接覆盖安装即可（install -r），你在 v1.0.0 里没有设过 Dock，升级后从空 Dock 开始用菜单键挑即可。

说明

• tvhome-zh-debug.apk 为 debug 签名（ADB 安装用途），非商店发布包。
• 详细的安装、自定义与源码编译说明见 README（中文）。

MIT License · 原项目版权 (c) 2026 Gathin · 本地化与 Dock 编辑改动 (c) 2026 mclhm8182

tvhome-zh v1.0.0 · tv-vibehack 中文版

tvhome-zh v1.0.0

tv-vibehack 的简体中文本地化版本 —— 把 Android TV / Google TV 换成 Apple TV（tvOS）风格桌面。

本版本是 Gathin23/tv-vibehack（MIT © 2026 Gathin）的中文衍生版。

亮点

• 🇨🇳 完整简体中文：问候语、输入源、设置、Wi-Fi 状态、错误提示、中文日期格式
• 🎯 通用默认配置：Dock / 直播电视入口默认留空，适合任意品牌电视盒子，用 config.xml 自行配置
• 📱 兼容 Android 11：targetSdk 29，不受 Android 11 包可见性限制，能枚举全部应用（国产盒子关键）
• 无广告、无账号、无需 root、无需数据线，纯 ADB 覆盖安装

安装

# 电视开启「USB 调试」后
adb connect <电视IP>:5555
adb install -r tvhome-zh-debug.apk
adb shell pm grant com.gathin.tvhome android.permission.ACCESS_FINE_LOCATION
adb shell cmd package set-home-activity com.gathin.tvhome/.MainActivity

按 Home 键即可看到新桌面。

说明

• tvhome-zh-debug.apk 为 debug 签名（ADB 安装用途），非商店发布包。
• 本仓库不包含开机自启功能：该功能需改代码重新编译才能配置，不适合作为通用桌面的默认特性。开机自动进直播请用系统或第三方自启工具实现。
• 详细的安装、自定义与源码编译说明见 README（中文）。

MIT License · 原项目版权 (c) 2026 Gathin · 本地化改动 (c) 2026 mclhm8182