CleanYourTV：通过 Wi-Fi 给任何 Android TV / Google TV 去臃肿、去广告，把广告满屏的原厂桌面换成一个像 Apple TV 一样干净的桌面。无需 root、不用数据线、不卸载任何东西，还有一行命令就能恢复。

GitHub: https://github.com/Gathin23/cleanyourtv（25.7k+ star，MIT） ｜ 官网: cleanyour.tv

中文版

来历

2026 年 10 月 17 日，作者发了一条推文：他家长辈的电视被 Claude Code 通过 Wi-Fi 清理前后的对比图。推文 740 万浏览，四天内 200+ 位贡献者贡献了 170+ 个电视型号的清理清单，仓库登上趋势榜第一，还被 TechCrunch、XDA、Android Authority 等 31 个国家 187 篇报道转载。

工作原理

Android 电视和手机有同一个调试桥（ADB）。在电视开发者选项里打开 USB 调试、电脑授权一次，剩下全是标准 Android 工具：

1. 备份：已安装应用列表和相关设置先存快照
2. 停用：用 pm disable-user 停用厂商遥测、广告服务、推荐内容和不需要的预装应用（和「设置 → 应用 → 停用」是同一个开关）
3. 换桌面：安装简洁的原生桌面并设为默认 HOME

不 root、不刷固件、不绕过任何锁或 DRM；什么都不卸载，tools/restore.sh 一键全部恢复。

快速开始

准备一台和电视同一局域网的电脑，加一个能跑终端命令的编程助手（Claude Code / Codex / Gemini CLI）：

1. 电视端：设置 → 关于里连点「版本号」七次进开发者选项，开启 USB 调试
2. 电脑端：把仓库的 PROMPT.md 交给助手，填上电视型号
3. 在电视上接受调试授权，告诉助手常用应用、要不要保留语音助手 / Chromecast / 系统更新
4. 助手完成备份、清理、装桌面，你检查应用启动、遥控、输入源和恢复路径

也可以纯手动：仓库 tools/tv.py 走 TCP ADB 5555 端口，tools/disable.sh 停用、tools/restore.sh 恢复。

桌面长什么样

• 深色简洁首页，默认四个常用应用组成底部快捷栏
• 应用聚焦展示：显示当前应用名，环境色从应用横幅（或图标）提取
• 应用网格每行 4–7 个可调；遥控器长按进排序模式调整位置
• 可选应用库：浏览所有可启动应用，添加/移除首页快捷方式（移除不卸载）
• 动效可开关，高级动效有卡片上浮、图标缩放、背景色平滑过渡
• Wi-Fi / 系统设置入口，设备支持时显示 HDMI 等输入源入口
• 时钟、问候语和配套时钟屏保；主题靠配置文件改颜色、壁纸、列数，不用重新编译
• 桌面 APK 只有 474 KB

支持哪些设备

清理清单面向 Android TV / Google TV，社区已验证 243 个型号、69 个品牌；桌面 APK 要求 Android 8.0（API 26）或更高。三星 Tizen、LG webOS 跑不了这个 Android 桌面；Fire TV 清理记录可手动适配，但 Fire OS 限制替换默认桌面，PROMPT.md 不适用；部分中国大陆版电视拒绝侧载或第三方 HOME，兼容性要按型号核对，不能只看品牌。

安全与许可

只用电视自己开放给机主的设置（开发者选项、ADB、pm disable-user）；仓库不含任何厂商软件、固件或 APK。改电视软件可能影响保修，风险自担。项目 MIT 许可。注意：官网只有 cleanyour.tv，同名的其他域名（如 cleanyourtv.com）与本项目无关。

English Version

CleanYourTV: strip the bloatware from any Android TV or Google TV over Wi-Fi and replace the ad-filled home screen with a clean launcher that looks like an Apple TV. No root, no cable, nothing uninstalled, and a one-line restore.

GitHub: https://github.com/Gathin23/cleanyourtv (25.7k+ stars, MIT) ｜ Website: cleanyour.tv

The story

On 17 October 2026 the author posted a before-and-after of his parents’ TV, cleaned up by Claude Code over Wi-Fi. It reached 7.4M views; within four days 200+ contributors had added debloat lists for 170+ TV models, the repo hit #1 trending, and it was covered by 187 articles in 31 countries (TechCrunch, XDA, Android Authority, and more).

How it works

Android TVs have the same debug bridge as Android phones. Switch on USB debugging in the TV’s developer options, allow your computer once, and the rest is standard Android tooling:

1. Back up the list of installed packages and settings
2. Disable vendor telemetry, ad services, recommendations and unwanted preinstalled apps with pm disable-user — the same switch as Settings → Apps → Disable
3. Install the clean native launcher and set it as the default HOME

No rooting, no firmware flashing, no bypassing locks or DRM. Nothing is uninstalled, and tools/restore.sh puts everything back.

Quick start

You need a computer on the same LAN as the TV and a coding assistant that can run terminal commands (Claude Code / Codex / Gemini CLI):

1. On the TV: tap Build seven times in Settings → About to unlock developer options, then enable USB debugging
2. On the computer: hand the repo’s PROMPT.md to your assistant and fill in your TV model
3. Accept the debugging prompt on the TV; tell the assistant which apps you use and whether to keep the voice assistant, Chromecast and system updates
4. The assistant backs up, cleans and installs; you check app launches, the remote, inputs and the restore path

Fully manual works too: tools/tv.py talks TCP ADB on port 5555, tools/disable.sh disables, tools/restore.sh restores.

The launcher

• Dark, clean home with a bottom dock of four favorite apps by default
• Focused app display with ambient color pulled from the app’s banner (or icon)
• App grid with 4–7 apps per row; long-press with the remote to reorder
• Optional app library: browse every launchable app, add/remove home shortcuts (removing never uninstalls)
• Toggleable animations, with advanced effects like card lift, icon scaling and smooth background color transitions
• Wi-Fi / system settings entries, plus input sources (HDMI etc.) when the TV exposes them
• Clock, greeting and a matching clock screensaver; themes via config files — colors, wallpaper, columns — no recompiling
• The launcher APK is just 474 KB

Compatibility

The debloat lists target Android TV / Google TV, with 243 models across 69 brands tested by the community; the launcher APK requires Android 8.0 (API 26) or higher. Samsung Tizen and LG webOS cannot run the Android launcher. Fire TV lists can be adapted manually, but Fire OS restricts replacing the default launcher and PROMPT.md doesn’t apply. Some mainland-China TVs reject sideloading or third-party HOME launchers — always check your exact model, not just the brand.

Safety and license

It only uses settings the TV itself offers its owner (developer options, ADB debugging, pm disable-user); the repo contains no manufacturer software, firmware or APKs. Changing a TV’s software may affect its warranty — you run it on your own TV at your own risk. MIT licensed. Note: the only official site is cleanyour.tv; lookalike domains such as cleanyourtv.com are not run by the project.

来源 / Source

• GitHub: Gathin23/cleanyourtv（25.7k+ star，MIT）
• 官网 / Website: cleanyour.tv