glasstv GlassTV · 玻璃桌面：给电视一块干净的玻璃桌面。开源 Android @codeKK AndroidOpen Source Website

glasstv

Introduction: GlassTV · 玻璃桌面：给电视一块干净的玻璃桌面。开源 Android TV 桌面，无广告无推荐，壁纸 + 翻页时钟屏保 + 六宫格控制中心，通用版 / 4.4 精简版双包。

Tags:

给电视一块干净的玻璃桌面。 没有广告位，没有推荐流，只有你的 App、你选的壁纸、和时钟屏保。

4.0.0 起正式改名 GlassTV

本仓库原名 cleanyourtv-k，从 4.0.0 起统一改名为 GlassTV（玻璃桌面）：仓库、官网、应用显示名、安装包文件名全部换新，包名同步改为 com.glasstv.tvhome。历史版本的 Release 与更新记录保持原样，不作改动。

因为包名变了，GlassTV 与旧版可以并存；旧版布局不会自动迁移，建议确认新版没问题后再卸载旧版。

本仓库是开源电视桌面 Gathin23/cleanyourtv 的中文二次开发版，融合了 BeatsAD/quiet-tv（壁纸模块，MIT）、 mclhm8182/tvhome-zh（必应每日壁纸）、 pengchujin/aerial-tv（桌面守护 / 一键更新 / 天气 / 返回键回顶）的功能。

小米国行电视实测可用（MiTV-ASTP0 / Android 9），理论上所有 Android TV 4.4+ 都能跑。

让 AI 帮你装（最省事）

不想自己敲命令？把下面这段话整段复制，发给能在电脑上跑命令的 AI 助手（Claude Code、Codex、Trae、豆包电脑版等），电脑和电视连同一 Wi-Fi 就行：

请帮我把开源电视桌面 GlassTV 装到我的电视上，并设为开机进入的桌面。
项目地址：https://github.com/jichun29/glasstv
请先完整读完仓库里的 PROMPT.md（安装说明）再动手：tools/ 和 launcher/ 直接复用，不用从头写。
我的电视型号是：____（填你的型号）

要求：在我的电脑上亲自运行命令，不要只把步骤告诉我；需要我在电视上操作时提醒我；
装完后把验证命令的原始输出贴给我。

完整指令词（英文原文，AI 直接读）在 PROMPT.md。开始前记得在电视上打开开发者选项里的 USB/网络调试（设置 → 关于 → 连按「版本号」7 次 → 开发者选项 → 打开调试）。

截图

全部为小米电视 MiTV-ASTP0 真机实拍：

桌面	控制中心	壁纸与屏保

壁纸 + 大号时间天气 + 应用栏，右上角信号源 / 网络 / 控制中心	六个入口：系统设置、桌面设置、内存清理、壁纸与屏保、检查更新、关于	顶部「壁纸 / 屏保」两个标签，默认停在壁纸页

屏保：三种样式	翻页时钟

时间 / 翻页时钟 / 必应每日，选中即生效；翻页时钟可选卡片大小小 / 中 / 大	两块翻页牌，下面天气地区与年月日周几

桌面设置（左设置 · 右实时预览）

左边改，右边立刻重画：壁纸、时间日期天气、真实应用图标都按当前设置摆出来

功能

首页

大号时钟 + 天气：壁纸上显示时间、日期、天气（城市温度天气低/高温，免 key 接口国内直连）。往下滚动时时钟淡出。
字号三档：标准 / 大 / 特大，日期与天气按比例跟随（桌面设置 → 时间与天气）。
应用网格：每行应用数量 4~~7 可调，应用栏下方保留 0~~3 行。
应用全收录：标准 TV 入口和手机入口都会显示，小米的「应用中心」「高清播放器」这类没标准入口的系统 App 也在。
返回键：在网格里按返回回到第一行；在第一行再按返回进入时钟屏保。
用手机改设置：桌面设置 → 系统 → 用手机改设置，电视出二维码，手机扫码就能改天气城市、壁纸、布局和屏保（不装 App、不联网、只在那一屏开着时可用）。

右上角：信号源 / 网络 / 控制中心

最常用的两件事固定在桌面右上角，不用每次开面板：

信号源：HDMI 1~3、AV 等输入端口，选中的端口上接了 CEC 设备（Apple TV、音箱）会直接显示设备名。
网络：显示当前 WiFi 名（有线时显示「有线」），点一下进网络设置。
控制中心：滑出毛玻璃面板，六个入口——系统设置 / 桌面设置 / 内存清理 / 壁纸与屏保 / 检查更新 / 关于。顶部显示时间日期与网络名，底部显示版本号。

壁纸与屏保

顶部「壁纸 | 屏保」两个标签，打开默认停在壁纸页，两张各自占满整屏（控制中心 → 壁纸与屏保）：

壁纸页：12 张内置壁纸——自然风景 4（海岸暮色 / 森林晨光 / 金色瀑布 / 雪山湖泊）、跑车 2、卡通场景 2、清简风景 4（大苏尔海岸 / 大苏尔群山 / 大苏尔山路 / 金门大桥日落），外加「默认」纯黑 + 光晕。4 列缩略图按分区排，方向键挑选、确定即应用；最底一行是壁纸轮播（默认关）和必应每日（默认关）两个开关。
屏保页：三种样式——时间屏保（细字大时钟，不联网也能一直用）、翻页时钟（照爆款 Fliqlo 那块：两块翻页牌 + 下方天气地区 + 年月日周几，整点/整分真的翻一下）和 必应壁纸屏保（每天一张新风景，可选每次 / 1 小时 / 1 天换图）；另有屏保总开关和预览。
翻页时钟可选卡片大小：小 / 中 / 大（默认中）。按小时牌与分钟牌各占屏宽的比例算，两块加起来的宽度分别是 42% / 52% / 63%，随尺寸等比缩放字号与两牌之间的缝；换小屏或坐得远就调大。
翻页牌是本地绘制：卡片上亮下暗的渐变 + 顶部高光 + 中缝三层阴影，下半数字比上半暗一档，做出塑料片的厚度；不联网也能走字。
焦点在标签行时左右键切页，进了内容区左右键归内容自己用；上键一律回标签行。
屏保总开关关掉后，待机再久也不会进屏保。

桌面设置（左设置 · 右实时预览）

整页分两栏：左边是设置，右边固定一块首页实时预览，改任何一项当场重画，不用退回桌面看效果。

实时预览：等比缩略的首页——壁纸用壁纸页当前那张（必应模式读本地已下载的图），时间日期天气按真实的中心区取；列数、保留行数、时间位置、字号、12/24 小时、问候语/日期/天气开关、图标名称，改哪个右边跟着变哪个；应用图标读你真的装了什么，不是画一个假格子。
布局：每行应用数量 4/5/6/7；应用栏下方保留行数 0~3；图标下常显名称；只显示常用应用（开了其余收进应用库）。
时间与天气：时间块位置左/中/右（整块跟着挪：居中、靠右改成竖排）；字号标准/大/特大；12/24 小时制（屏保也跟着变）；问候语、日期、天气逐项开关；天气城市自动定位、不用手打。
背景颜色：纯黑 / 午夜蓝 / 酒红 / 石板灰（壁纸关掉或缺图时才看得见）。
动效：动态效果 / 减弱动画 / 高级动态效果 / 恢复主题默认。

菜单键 = 应用菜单

选中 App 按遥控器「菜单 ≡」键：打开 / 从主屏幕隐藏 / 置顶 / 移动位置 / 卸载 / 应用信息。

自动清理内存

按间隔清理后台进程，可设白名单保住要常驻的应用，也能随时手动清一次。

桌面守护

小米等国行固件待机时会强杀第三方桌面，醒来露出自带广告桌面。桌面守护（无障碍服务）盯着窗口切换：原生桌面一冒头就把 GlassTV 拉回来。只盯窗口、不读内容、不拦按键。

开启方式：装好后用 adb 一次性打开：

adb shell settings put secure enabled_accessibility_services com.glasstv.tvhome/com.glasstv.tvhome.HomeGuardService
adb shell settings put secure accessibility_enabled 1

一键更新

控制中心 → 检查更新：查到新版本后点「下载并安装」，应用内下完 APK 直接交系统安装器，装完自动重启桌面。不用开电脑、不用跳浏览器。

数据源只读本仓库 Releases，不联网第三方、不上报任何数据
自动检查默认关闭，开了每 3 小时查一次
GitHub 直连失败时自动切换 ghfast.top / ghproxy.net / gh-proxy.com 加速源
「跳过此版」：同一版不再提醒

时钟屏保

闲置 5 分钟自动进入（可配），大号时钟每分钟漂移换位置换色，不会烧屏。任何按键退出。

防烧屏 & 电视安全

屏保时钟每分钟漂移 + 换色
弹窗/面板都是临时悬浮，按返回即销毁
不写系统亮度等关键设置，不和厂商画质模式打架
1GB 内存的电视也不崩：壁纸后台解码、按屏幕尺寸降采样、内存紧张自动释放

下载

到 Releases 下载，按设备选一个：

安装包	支持系统	说明
`GlassTV-Launcher-universal.apk`	Android 5.0+	通用版，功能完整，绝大多数电视/盒子用这个
`GlassTV-Launcher-lite44.apk`	Android 4.4+	4.4 精简版，砍必应每日壁纸、视频壁纸、在线壁纸（4.4 缺相关接口），其余全保留

两个版本签名一致，可互相覆盖安装不丢设置。

安装

全程不需要 root，不卸载、不停用任何系统应用，随时一条命令还原。

第一步：打开电视的 ADB 调试

电脑和电视连同一个网络。先在电视上找到 IP（一般在「设置 → 网络」或「关于」里），再开 ADB：

电视	怎么打开
小米 / Redmi（PatchWall、HyperOS）	设置 → 账号与安全 → ADB 调试打开；同一页的安装未知来源的应用也打开
TCL / 雷鸟	设置 → 关于 → 本机信息，遥控器依次按上、下、左、右，底部出现隐藏分组，选中 ADB 按确认
原生 Android TV / Google TV、海信等	设置 → 设备偏好 → 关于 → 连按版本号 7 次开开发者选项；再到开发者选项 → USB 调试打开

更全的品牌列表（华为/创维/长虹/康佳/极米等）见 docs/tv-adb-guide.md。

电脑第一次连接时电视上会弹「允许 USB 调试吗」，选允许（勾「始终允许」）。

第二步：装桌面

adb connect <电视 IP>:5555
adb install -r GlassTV-Launcher-universal.apk
adb shell cmd package set-home-activity --user 0 com.glasstv.tvhome/.MainActivity

按遥控器 Home 键，看到新桌面就成了。

第三步（可选）：开桌面守护

小米用户强烈建议开——不然待机后可能回到 PatchWall。用 adb 一次性打开：

adb shell settings put secure enabled_accessibility_services com.glasstv.tvhome/com.glasstv.tvhome.HomeGuardService
adb shell settings put secure accessibility_enabled 1

还原成原来的桌面

adb shell cmd package set-home-activity --user 0 <原桌面包名>/.<原桌面 Activity>
adb shell pm uninstall com.glasstv.tvhome

不知道原桌面包名？装之前先记一下：adb shell cmd package resolve-activity -c android.intent.category.HOME -a android.intent.action.MAIN

从旧版（CleanYourTV 3.x）升级

4.0.0 换了包名，所以是并行安装，两个桌面可以同时存在：

adb install -r GlassTV-Launcher-universal.apk
adb shell cmd package set-home-activity --user 0 com.glasstv.tvhome/.MainActivity

确认新版正常后，再卸载旧版：

adb uninstall com.gathin.tvhome

旧版的桌面排序、壁纸选择不会自动迁移（存在各自的私有目录里），需要在 GlassTV 里重新设一次。

常见问题

装完按 Home 没反应 / 又回到原桌面？ 跑一次 adb shell cmd package set-home-activity --user 0 com.glasstv.tvhome/.MainActivity。小米装新 App 后默认 Home 会被重置，这是正常现象。开了桌面守护就不会再跑丢。

待机后醒来变回小米桌面？ 开桌面守护（上面第三步）。小米待机会强杀第三方 App，守护会在原生桌面冒头时把 GlassTV 拉回来。

天气不显示 / 城市不对？ 默认按网络定位自动识别城市。想固定成某个城市：桌面设置 → 时间与天气 → 天气城市，点开填中文城市名保存（清空 = 改回自动定位）。定位需要给应用位置权限。遥控器打字嫌麻烦，可以走「桌面设置 → 系统 → 用手机改设置」，电视上出二维码，手机扫码在同一 Wi-Fi 下改。

电视上没有应用详情页/卸载不了 App？ 国行小米阉割了标准应用详情 Intent。桌面里的「管理/卸载」已做适配：自动跳小米电视管家的应用管理页。

某些 App 图标没显示名字？ QQ 音乐、夸克这类 App 没做 TV banner，桌面只能显示图标，这是 App 本身的问题，改不了。

点「系统设置」提示此电视不支持？ 已按运行期自找处理：先试厂商入口，再枚举系统里所有能响应「设置」的 Activity，最后在厂商包里按类名找。雷鸟/TCL、小米这类改过设置的固件都能进。个别固件若仍进不去，把电视型号反馈一下即可补进去。

手机扫码页打不开？ 确认手机和电视连的是同一个 Wi-Fi（不是手机热点，也不是访客网络）。页面只在「用手机改设置」这一屏开着时提供，退出即关。

4.4 老盒子能装吗？ 装精简版（lite44）。Android 5.0 以下没有 TvInputManager 框架，「信号源」按钮降级为打开电视自带的选源面板。

支持哪些电视？ 实测：小米 MiTV-ASTP0（Android 9）、雷鸟/TCL（Android TV）、模拟器 Android 4.4/5.1/14。理论支持所有 Android TV 4.4+。更多机型的适配笔记见 docs/devices/。

📢 电视去广告库（174 机型）

仓库自带 debloat/ 目录：174 个电视/盒子/投影机型的去广告清单，每条注明这个包是干什么的、停用后失去什么。**只停用、不卸载，随时一键还原。**详见 debloat/README.md。

构建

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

cd launcher
./gradlew assembleRelease                      # 通用版（minSdk 21）
./gradlew assembleRelease -PliteBuild=true     # 4.4 精简版（minSdk 19）

产物：launcher/app/build/outputs/apk/release/app-release.apk。