Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.

★ 58,423⑂ 7,636👁 161⑃ 3,155● 622▤ 13
PythonNOASSERTIONCreated 2026-10-17cleanyour.tv
下载:CleanYourTV 3.5: eight new themes, 472 TV models and a lighter HomeCleanYourTV-3.5.0 ↓3.5.02026-11-14
+414
日增长
+3,430
周增长
58,423
stars
7,636
forks
161
watchers
3,155
prs
622
issues
13
releases

README

English · עברית · 简体中文 · 正體中文 · Tiếng Việt · 日本語 · Italiano · Português · Nederlands · Deutsch · Українська · Türkçe · Oʻzbekcha · Français · Español



  项目网站 ·
  操作提示词 ·
  机型清单 ·
  社区作品


 CleanYourTV 中文使用指南

通过局域网连接 Android TV 或 Google TV,停用不需要的预装应用、广告和遥测服务,并在兼容设备上安装简洁的原生桌面。无需 root、刷机或 USB 数据线;清理工具采用停用方式,不卸载系统应用,并提供恢复脚本。

本文介绍通用功能和使用方法。不同机型、地区和固件的应用包及限制可能不同,请先核对自己的设备。功能变化以英文 README为准,具体机型记录见机型清单。

Samsung、LG、Roku 或其他非 Android 电视? CleanYourTV 无法在这些电视上运行,但你仍可以用遥控器一步步关闭跟踪功能:cleanyour.tv/not-android

!原生 Google TV 桌面与 CleanYourTV 桌面对比

 工作原理

电视开启开发者选项中的 USB 调试,建立并授权网络 ADB 连接后,就可以完成以下步骤:

1. 备份已安装应用列表及相关设置。使用操作提示词时,先让助手保存完整快照;手动使用 tools/disable.sh 时,工具仅保存恢复该停用列表所需的状态。
2. 按需停用厂商遥测、广告服务、推荐内容和不需要的预装应用,使用的是 pm disable-user。
3. 安装简洁桌面,并将其设为默认 HOME。

各品牌需要保留的系统组件不同。操作提示词会引导编程助手先检查实际设备,再确认你使用哪些应用和功能。

 快速开始

准备一台与电视连接同一局域网的电脑,以及可以运行终端命令的编程助手,例如 Claude Code、Codex 或 Gemini CLI。

| 步骤 | 操作 |
|---|---|
| 1. 电视端 | 打开「设置 → 设备偏好设置 → 关于」,在「版本号 / Build」上连续按七次确定,返回后进入开发者选项,开启 USB 调试。如果另有网络调试或 ADB 调试开关,也需要开启。菜单名称因机型而异。 |
| 2. 电脑端 | 先克隆仓库并在助手中打开该文件夹(git clone https://github.com/Gathin23/cleanyourtv),再将 PROMPT.md 的内容交给助手,填写电视型号。 |
| 3. 确认需求 | 在电视上接受调试授权,告诉助手常用应用、底部快捷栏中的应用,以及是否保留语音助手、Chromecast 和系统更新。 |
| 4. 检查结果 | 按提示完成备份、清理和安装,检查应用启动、遥控器操作、输入源和恢复路径。 |

先克隆仓库的意义在于:助手会直接使用本仓库的 tools/disable.sh 和 launcher/build-and-install.sh,不会另写一套;备份、默认桌面保护和恢复记录都在其中。

 桌面功能

- 简洁首页:深色背景,默认四个常用应用组成底部快捷栏。
- 应用聚焦展示:显示当前应用名称;环境色优先从应用横幅提取,没有横幅时才从图标提取。
- 应用网格:按向下键进入更多应用,支持每行 4、5、6 或 7 个。
- 遥控器排序:从设置按钮的长按菜单进入排序模式,调整应用位置。
- 可选应用库:浏览已安装且可启动的应用,用遥控器添加或移除首页快捷方式。
- 动效控制:可开关动态效果,也可单独启用高级动态效果。
- 常用入口:Wi-Fi / 以太网和系统设置;设备有可识别的 HDMI、AV、直播电视或已配置来源面板时,还会显示输入源入口。HDMI 名称沿用电视系统中的命名。
- 时钟与屏保:问候语、时间、日期,以及配套的时钟屏保。
- 主题:通过配置文件调整颜色、壁纸、快捷栏和列数,无需重新编译。
- 模块卡片:其他应用可以提供桌面卡片,需用户同意才会显示。

!应用聚焦效果

 在电视上调整设置

默认短按「设置」打开电视系统设置,长按后可进入「简洁桌面设置」。在配置或主题中启用 launcher_settings_button 后,顶部改为独立的「简洁桌面设置」按钮,短按即可进入;长按仍可打开模块卡片和应用排序工具,电视系统设置也可从设置页面或下方应用图标进入。

启用独立按钮后,页面还提供「调整应用顺序」,点击即可返回桌面进入移动模式。

可调整:

| 选项 | 作用 |
|---|---|
| 每行应用数量 | 选择 4、5、6 或 7 个,列数增加时卡片相应缩小。 |
| 动态效果 | 开启或关闭桌面动画。 |
| 高级动态效果 | 增加卡片上浮、图标缩放和背景颜色平滑过渡。可能增加内存占用,实际影响取决于电视。 |
| 跟随主题(重置电视端设置) | 清除电视端的布局与动效选择,恢复当前主题或内置配置。推送或重置主题也会清除这些选择。 |
| 默认桌面入口 | 打开 Android 的默认桌面选择页,切换到原始桌面或 CleanYourTV。 |

默认桌面入口不负责重新启用已停用的原始桌面。如果原始桌面已被安装脚本停用,需要先按下文恢复。部分电视不提供系统桌面选择页。还可以通过 show_home_settings_shortcut 配置单独显示该入口。

 排序与应用库

在桌面「设置」按钮上长按确定,通过菜单进入排序模式。按确定选中要移动的应用,用方向键调整位置,再按确定或返回放下;没有拿起应用时,按返回退出排序并保存。顶部独立排序按钮默认隐藏,可通过配置或主题的 reorder_button 开启。

应用库默认关闭,在配置或主题中启用 app_library 后,入口显示在首页应用的最后一行之后。它可以列出具有电视或普通 Android 启动入口的应用;普通 Android 应用可能仍需触摸或鼠标操作。

另可启用默认关闭的 app_library_selection:按确定直接切换右上角勾选,选择是否在首页显示。已勾选和未勾选分别按显示名称排序,勾选组排在前面;取消后焦点选相邻的下一个,末尾则选前一个,不跟随隐藏的应用移到后组。

- 对尚未添加到首页的应用按确定,可添加快捷方式。
- 对已经在首页的应用按确定,可打开应用;长按可打开操作菜单,添加或移除首页快捷方式,也可查看应用信息。
- 从首页移除不会卸载应用。相关选择在重启、应用更新及推送或重置主题后保留。

详见应用库说明。

 支持哪些设备

清理清单面向 Android TV / Google TV;当前桌面 APK 要求 Android 8.0(API 26)或更高版本。社区提供了多种电视与电视盒子的配置;其中一些设备运行的 Android 版本低于桌面的最低要求,清理清单不代表桌面可安装。请在机型清单中核对型号、地区和固件,阅读对应目录的说明,再使用停用列表。

- Samsung Tizen 和 LG webOS 不能直接运行

Top issues

Discussions

Latest release

CleanYourTV 3.5: eight new themes, 472 TV models and a lighter Home v3.5.0 2026-11-14
Nine days, 355 pull requests from 152 people. CleanYourTV 3.5 brings eight new themes, from Diwali lamps to Istanbul at night, three new add-ons, 30 more TVs from 12 new brands, and a Home screen that no longer holds on to memory it doesn't need. The README now reads in Spanish, French, Hebrew and Uzbek too.

Since v3.4.0: 472 TV models (from 442), 129 brands (from 117), 29 themes (from 21), 36 add-ons (from 33), 243 projects in the showcase (from 212), 355 pull requests from 152 people. No binaries, as always: build the launcher with launcher/build-and-install.sh.

 Highlights
- Eight new the

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON