电视去广告,桌面回归简洁
CleanYourTV(GitHub 搜 Gathin23/cleanyourtv,原仓库名 tv-vibehack,社区里也有人叫它 Luma Launcher)是一个给安卓电视 / 谷歌电视去广告、去臃肿应用、换干净桌面的开源工具。
核心原理:电视打开开发者选项里的 USB 调试并授权网络 ADB 后,电脑就能通过局域网连接电视:先备份应用列表,再用 pm disable-user 按需停用厂商遥测、广告服务、推荐内容和不需要的预装应用(停用而非卸载,不动系统文件),然后安装一个简洁的深色桌面(默认四个常用应用的 Apple TV 风首页)并设为默认 HOME。全程无需 root、无需刷机、无需 USB 数据线,清理记录保存在电脑,配有一键恢复脚本。
版本沿革:项目 2026-10 上线,GitHub 上已获 2.2万 Star(2,366 fork),Java 语言,今天仍在活跃更新。协议 MIT(以仓库 LICENSE 为准),官网 cleanyour.tv。
✨ 核心亮点
- 电视去广告:停用预装广告、遥测、推荐内容
- 干净桌面:Apple TV 风简洁首页,深色背景
- 无需 root/刷机:局域网 ADB 停用,不卸载系统应用
- 一键恢复:恢复脚本 + 停用前记录,可撤销
🖼️ 效果图与演示


🚀 上手步骤
⚠️ 有操作门槛:先核对你的电视型号在社区「机型清单」里有没有记录,别把别的机型停用列表直接用到自己电视上;操作前务必保留恢复路径。
① 电视端:开启开发者选项 + USB 调试
「设置 → 设备偏好设置 → 关于」,在「版本号 / Build」上连按七次,返回进入开发者选项,开启 USB 调试(有网络调试 / ADB 调试开关也一并开启)。菜单名称因机型而异。
② 电脑端:准备工具
git clone https://github.com/Gathin23/cleanyourtv
cd cleanyourtv
python3 -m venv tools/venv
tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50
tools/venv/bin/python -I tools/tv.py --probe
③ 按需应用停用列表
在电视上接受调试授权;用与你机型匹配且已核对的列表,分批停用遥测、广告与不用的预装应用。保留恢复记录。
tools/disable.sh examples/你的机型/debloat.txt
# 恢复:tools/restore.sh examples/你的机型/debloat.txt
④ 编译安装桌面并设为默认 HOME
TV_HOST=192.168.1.50 launcher/build-and-install.sh
# 完成后:务必关闭电视 USB/网络调试,撤销调试授权
🎯 典型玩法
- 📺 电视主屏去广告:干掉预装广告与推荐磁贴
- 🎨 换干净桌面:Apple TV 风首页,底部四个常用应用
- 🗑️ 精简臃肿预装:停用不用的厂商服务与应用
- 🔕 关遥测:停用厂商遥测与数据采集服务
- 🎮 客厅电视盒子:给各种安卓电视盒子做干净系统
- ↩️ 一键恢复:想回原样随时用恢复脚本还原
📊 与同类做法比
| 做法 | 结果 |
|---|---|
| 装第三方「去广告」App | 大多只拦网络层,桌面广告/推荐磁贴清不掉,还常要付费 |
| Root 后精简系统 | 能彻底删,但要解锁/刷机,有变砖风险,兼容差 |
| CleanYourTV | 局域网 ADB 停用(不卸载)+ 干净桌面 + 一键恢复,无需 root |
原理一句话:通过网络 ADB 用 pm disable-user 停用(而非卸载)遥测/广告/预装应用,再切一个自绘的简洁桌面当默认 HOME,并把操作前状态记下来供恢复。
❓ 常见问题
Q:会刷机或删除系统应用吗?
不会。清理通过「停用应用」实现,不卸载系统应用;但停用系统依赖仍可能造成故障,所以必须按机型核对、分批处理并保留恢复路径。
Q:支持哪些电视?
Android TV / Google TV;桌面 APK 要求 Android 8.0(API 26)+。Samsung Tizen / LG webOS 不能直接跑,Fire TV 限制较多,部分国产电视会拒绝侧载第三方 HOME,先查机型清单。
Q:操作难吗?有门槛吗?
有门槛:要开开发者选项、启网络 ADB、按型号核对停用列表、编译需要 JDK17 + Android SDK。建议先用编程助手按 PROMPT.md 走,并在社区找自己机型的现成记录。
Q:怎么恢复原样?
用 tools/restore.sh 按停用列表恢复,记录存在电脑 ~/.cleanyourtv/;也可在电视「设置 → 应用」里重新启用相关应用。恢复脚本不会卸载桌面。
Q:系统更新和 App 更新受影响吗?
部分停用列表包含系统更新服务,要接收固件更新需先重新启用;常用流媒体应用仍可通过保留的应用商店更新。
Q:操作完要做什么?
必须关闭电视的 USB 调试及网络/ADB 调试、撤销调试授权;不要在路由器上把 ADB 端口暴露到公网。
Q:能远程帮别人操作吗?
可通过私有 Tailscale 网络远程连接;不要公开暴露 ADB 端口到互联网。
Q:有现成 APK 吗?
目前仓库推荐通过安装脚本编译安装,方便按设备调整配置;社区机型清单里有已记录设备的用法。
📎 GitHub 搜索 Gathin23/cleanyourtv · 官网 cleanyour.tv · 关注「AI工具匠」获取更多 AI 工具实操教程