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

CleanYourTV 封面

好家伙,你家电视是不是也这样?

开机先看 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 到底是什么来头?

先看仓库数据(截至发文时):

CleanYourTV GitHub 仓库

项目 数据
仓库 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

需要准备的东西:

  1. 一台和电视连同一个 Wi-Fi 的电脑(Windows/Mac/Linux 都行);
  2. 电脑上装好 Python 3(任意 3.x 版本);
  3. 想自己编译桌面的话,需要 JDK 17~22 + Android SDK 34(不想折腾环境?看下面的偷懒方案);
  4. 一个 AI 编程助手(Claude Code、Codex、Gemini CLI 都行)——这是官方推荐的最省事路线,15 分钟搞定。

三、第一步:打开电视的调试开关

不同品牌菜单长得不一样,逻辑都一样:

  1. 电视遥控器进 设置 → 设备偏好设置 → 关于;
  2. 找到 版本号(Build),对着它连按 7 次 OK 键,屏幕会提示”您已处于开发者模式”;
  3. 退回上一级,找到新出现的 开发者选项;
  4. 把 USB 调试 打开;如果看到 网络调试 / ADB 调试 开关,也一并打开;
  5. 电视保持开机,别关。

小提示:小米电视在「设置 → 账号与安全」里也能直接看到 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 键,你看到的就是这个:

CleanYourTV 新桌面

具体都改了啥:

  • 纯黑首页 + 底部 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 分钟把电视变回”电视”。

家里有安卓电视的,强烈建议先备份、再动手,试完不满意一行命令还原,零风险。别忘了先查一下你的机型在不在清单里,能省不少事。

关注公众号:「实用软技」,在公众号窗口里回复关键字“软件”即可免费获取

100T高转存免费网盘资源精选【持续更中~~~~】:点击查看

发表回复