GitHub周榜No.1!CleanYourTV保姆级教程:15分钟给安卓电视去广告,换上Apple TV风桌面(49k Star)
目录

好家伙,你家电视是不是也这样?
开机先看 15 秒广告,主屏一半是”猜你喜欢”的推荐流,预装的几十个用不上的 APP 删又删不掉,遥控器按到冒烟都找不着自己装的应用在哪。想装个第三方桌面吧,又怕要 Root、怕变砖、怕失去保修。
别急,最近 GitHub 上有个项目直接把这事办明白了——CleanYourTV,10 月 19 日到 25 日那周的 GitHub 全球周榜 No.1,现在狂揽 49k+ Star、6.1k Fork,被 TechCrunch、XDA、机器之心等 400 多家媒体报道过。它干的事就一句话:
不用 Root、不用数据线、不卸载任何东西,连上 Wi-Fi 就能把电视的广告、遥测、预装垃圾全停用,再换上一个 Apple TV 风格的干净桌面。
最关键的是:随时能一键恢复原厂状态。今天这篇保姆级教程,一步步带你把家里的安卓电视安排明白。
一、CleanYourTV 到底是什么来头?
先看仓库数据(截至发文时):

| 项目 | 数据 |
| 仓库 | Gathin23/cleanyourtv |
| Star / Fork | 49k+ / 6.1k |
| 开源协议 | MIT(可放心商用、改造) |
| 覆盖机型 | 407 款电视型号 · 106 个品牌 · 31 种语言 |
| 桌面体积 | 仅 572 KB |
| 最新版本 | v3.3.0(支持长按 OK 键移动应用) |
它由两部分组成:
- 清理工具:通过局域网 ADB(Android 调试桥,就是安卓手机开发者模式里那个调试通道)连上电视,把厂商的广告组件、数据遥测、推荐流、预装垃圾停用(注意是停用不是卸载,所以能随时恢复);
- 极简桌面:一个 572KB 的原生启动器(Launcher,就是电视按 Home 键回到的那个主界面),纯 Java 写的,不联网、无后台服务、1GB 内存的老电视都跑得动,界面直接对标 Apple TV。
下面是改造前后的真实对比(左:原厂带广告桌面,右:CleanYourTV 桌面):

效果是不是挺明显的?满屏推荐流变成了纯黑背景 + 你自己的四个常用应用。
二、开工前的准备(5 分钟)
先确认你手里的设备:
| 你的电视 | 能不能用 |
| 安卓电视 / Google TV(小米、TCL、海信、索尼、飞利浦等) | ✅ 完全支持,清理 + 桌面都行 |
| Amazon Fire TV | ⚠️ 只能清理,桌面换不了(系统不放权) |
| 三星(Tizen)、LG(webOS)、Roku、Vizio、海信 VIDAA | ❌ 不支持(压根没有 ADB),关追踪设置见 cleanyour.tv/not-android |
需要准备的东西:
- 一台和电视连同一个 Wi-Fi 的电脑(Windows/Mac/Linux 都行);
- 电脑上装好 Python 3(任意 3.x 版本);
- 想自己编译桌面的话,需要 JDK 17~22 + Android SDK 34(不想折腾环境?看下面的偷懒方案);
- 一个 AI 编程助手(Claude Code、Codex、Gemini CLI 都行)——这是官方推荐的最省事路线,15 分钟搞定。
三、第一步:打开电视的调试开关
不同品牌菜单长得不一样,逻辑都一样:
- 电视遥控器进 设置 → 设备偏好设置 → 关于;
- 找到 版本号(Build),对着它连按 7 次 OK 键,屏幕会提示”您已处于开发者模式”;
- 退回上一级,找到新出现的 开发者选项;
- 把 USB 调试 打开;如果看到 网络调试 / ADB 调试 开关,也一并打开;
- 电视保持开机,别关。
小提示:小米电视在「设置 → 账号与安全」里也能直接看到 ADB 开关;TCL 部分机型藏在「系统 → 关于 → 更多」。实在找不到就拿你电视型号 + “开启 ADB” 搜一下。
四、第二步:电脑端连接电视
把仓库克隆到本地:
git clone https://github.com/Gathin23/cleanyourtv
cd cleanyourtv
国内直连 GitHub 慢的话,可以用镜像加速:
git clone https://ghproxy.net/https://github.com/Gathin23/cleanyourtv
cd cleanyourtv
装一下工具依赖(tools 目录的脚本要用):
python3 -m venv tools/venv
tools/venv/bin/pip install -r tools/requirements.txt
然后探测你的电视(把 IP 换成你电视的实际局域网 IP,电视的 IP 在「设置 → 网络 → 当前网络详情」里能看到):
export TV_HOST=192.168.1.50
tools/venv/bin/python -I tools/tv.py --probe
第一次连接时,电视屏幕上会弹出”允许 USB 调试吗?”,用遥控器选”允许”(建议顺手勾上”一律允许”)。probe 成功会打印出电视型号、安卓版本、固件版本,说明通了。
五、第三步:清理广告 + 装上新桌面
路线 A:有 AI 编程助手(推荐,15 分钟)
用 Claude Code / Codex / Gemini CLI 打开刚才克隆的文件夹,把仓库里的 PROMPT.md 内容整个粘进去,填上你的电视型号,剩下的它自己干:备份 → 停用垃圾组件 → 编译安装桌面 → 截图验证每一步。它还会边干边问你:”哪些应用要保留?桌面放几个应用?语音助手、Chromecast、系统更新要不要留?”
路线 B:手动执行(不想用 AI 就照这个来)
# 1. 先备份(重要!生成可恢复的记录)
tools/venv/bin/python -I tools/recovery.py
# 2. 应用清理列表(用仓库里 examples/ 对应你机型的清单)
TV_HOST=192.168.1.50 tools/disable.sh examples/<你的机型>/disable.txt
# 3. 编译并安装桌面,设为默认 Home
launcher/build-and-install.sh 192.168.1.50
# 没装 Android SDK?用 Docker 编译,电脑啥都不用装:
tools/docker-build.sh
SKIP_BUILD=1 launcher/build-and-install.sh 192.168.1.50
搞完之后按遥控器 Home 键,你看到的就是这个:

具体都改了啥:
- 纯黑首页 + 底部 Dock:你最常用的 4 个应用放在苹果 TV 同款位置;
- 顶部书架:聚焦哪个应用,上方就大字显示它的名字,还带一层取自应用图标颜色的氛围光;
- 往下按:其余所有应用以网格铺开,一个玻璃质感的高亮框在格子之间弹跳;
- 三个磨砂按钮:信号源(HDMI1/2/AV)、网络、设置,一步直达;
- 问候语 + 细时钟 + 日期,还有配套的时钟屏保(缓慢漂移防烧屏);
- 16 套主题,一条命令切换,不用重新编译。
聚焦效果长这样:

六、后悔了?一行命令恢复原样
这是这个项目最厚道的地方:所有清理都是”停用”,且动手前自动记录了状态。想恢复出厂状态:
# Android TV
tools/restore.sh
# Google TV(连默认桌面一起还原)
tools/restore.sh -Stock com.google.android.apps.tv.launcherx
停用的应用全部回来,原厂桌面也回来了,跟没动过一样。
七、新手常见问题(FAQ)
Q1:会变砖吗?要 Root 吗?
不变砖、不 Root、不刷机。全程走标准 ADB 通道,最坏情况就是恢复脚本一键还原。项目脚本还有个”Home 保护”机制:只要没装上新桌面,就绝不会把原厂桌面停用,保证电视永远有界面可回。
Q2:系统更新后广告回来了怎么办?
固件更新可能把停用的组件重新启用。跑一次 tools/check.py 对比当前状态和你应用过的清单,加 --fix 就能补回去。
Q3:我家电视不在 407 个机型清单里?
没关系,清单只是”预设答案”,没有清单工具也能自己探测电视上有什么垃圾组件。你操作完可以把自己的清单提交回仓库,下一个同型号用户就省事了。
Q4:电脑不会敲命令怎么办?
官网 cleanyour.tv/app 提供了社区做的手机 App(安卓)、Mac、Windows 客户端,都是开源的,图形界面点点点就行。
Q5:会不会偷我数据?
新桌面本身没有任何网络权限,不联网、无后台服务;清理工具跑在你自己电脑上,所有记录都在本地。想审计电视上谁在收集数据,仓库还带了 tools/privacy.py,一条命令列出证据。
八、下载地址
官方 GitHub 仓库(源码 + 全部机型清单 + 中文文档):
https://github.com/Gathin23/cleanyourtv
中文版 README(照着做就行):
https://github.com/Gathin23/cleanyourtv/blob/main/README.zh-CN.md
最新版 Release(v3.3.0):
https://github.com/Gathin23/cleanyourtv/releases/tag/v3.3.0
源码包直链(zip,约 30MB):
https://codeload.github.com/Gathin23/cleanyourtv/zip/refs/heads/main
官网(机型查询 / 社区 App / 关追踪指南):
https://cleanyour.tv
⚠️ 提醒:国内直连 GitHub 可能超时,可加镜像前缀 https://ghproxy.net/ 下载,或使用官网 cleanyour.tv/app 的图形客户端。
写在最后
说实话,现在还能找到这种”不碰你系统一根汗毛、随时能反悔”的开源工具真不容易。以前想去个广告,不是找来路不明的 APK 就是折腾 Root;现在一个局域网 ADB + 572KB 的小桌面,15 分钟把电视变回”电视”。
家里有安卓电视的,强烈建议先备份、再动手,试完不满意一行命令还原,零风险。别忘了先查一下你的机型在不在清单里,能省不少事。
关注公众号:「实用软技」,在公众号窗口里回复关键字“软件”即可免费获取
