README

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



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


 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 不能直接运行本项目的 Android 桌面；docs/

Top issues

Discussions

Latest release

Think of CleanYourTV as the Linux of smart TVs: an open base that anyone can start from. In four days, people built on it again: five new themes, from photos taken on the space station to a snowy night with Santa's sleigh, two new add-ons, and 212 projects in the showcase, made by people who took the launcher and made it theirs. The launcher itself gets fixes for clocks that stopped, Mi TV picture settings and remote buttons that opened the wrong app.

Since v3.3.0: 442 TV models (from 407), 117 brands (from 106), 21 themes (from 16), 33 add-ons (from 31), 212 projects in the showcase (from 17