这个项目有什么用
cleanyourtv 是一个面向 Android TV 与 Google TV 的开源工具集,通过 Wi-Fi 上的 ADB 调试桥对电视做「去膨胀」处理,并安装一个类似 Apple TV 风格的桌面启动器。它解决的是智能电视出厂预装应用过多、首页塞满赞助内容与推荐位、后台分析持续上报的问题,让电视回到干净、可用的状态。
传统做法是拿遥控器在设置里逐个卸载或禁用应用,费时且容易误删;这个项目把备份、禁用、恢复、桌面替换都写成了脚本,并且可以由编码助手根据你的电视型号自动发现可清理项。
典型使用场景
- 新买的 Android TV / Google TV 开机后广告和预装应用太多,想一次性清理干净。
- 想把原生桌面换成更简洁、更接近 Apple TV 风格的首页。
- 想保留随时回滚的能力,清理后不满意可以一条命令恢复原厂桌面。
- 适合愿意在电脑上开一个终端、和电视处于同一 Wi-Fi 的开发者或个人用户;也适合把清理清单贡献回仓库、帮助同型号用户。
核心特性
- 无需 root、无需线缆:只要在电视的开发者选项里打开 USB 调试并允许电脑连接一次,后续全部走网络 ADB,官方描述强调「不 root、不插线、不卸载任何应用」。
- 可一键恢复:脚本会记录改动,
tools/restore.sh能撤销清理清单,把原厂桌面装回来。 - Home 键保护机制:安装与禁用脚本会先询问电视当前哪个应用拥有 Home,只禁用
KNOWN_STOCK_LAUNCHERS中列出的四个已知原厂桌面(com.google.android.tvlauncher、com.google.android.apps.tv.launcherx、com.google.android.leanbacklauncher以及小米的com.mitv.tvhome),避免电视出现「没有桌面可启动」的情况。 - 按品牌发现膨胀应用:不同品牌的预装内容不一样,README 说明提示词会让编码助手在你的电视上自行发现,并在动任何你可能在用的应用前先询问。
- 社区实测清单:仓库的
examples/目录按型号一个文件夹,收录了来自 200 多位贡献者的 170 多个电视型号的清理清单。 - 主题系统:提供
tools/theme.sh推送主题,例如themes/aurora,用--reset可移除。
怎么安装
前提条件:电脑与电视处于同一 Wi-Fi;电视已在开发者选项中开启 USB 调试并允许电脑连接一次;手动方式只需要 Python 3,没有其他依赖。README 未提供独立的「安装」章节,以下按「Doing it by hand」整理。
- 创建虚拟环境并安装依赖:
python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt - 设置电视的 IP 地址环境变量(把示例地址换成你自己的):
export TV_HOST=192.168.1.50 # your TV's IP address - 探测电视信息,确认连接正常:
tools/venv/bin/python -I tools/tv.py --probe # model, Android version, firmware - 如果 5555 端口不通、电视提供的是带配对码的无线调试(如 Chromecast with Google TV 与 Google TV Streamer),先用原版
adb配对一次,再执行adb tcpip 5555,具体见docs/TROUBLESHOOTING.md#connecting。 - Windows 用户可使用同目录下的 PowerShell 版本,README 说明在装有 Android Studio 的 Windows 上无需其他准备:
python -m venv toolsvenv; toolsvenvScriptspython.exe -m pip install -r toolsrequirements.txt
怎么使用
最基础的用法是在电视上执行一条 shell 命令,确认 ADB 通路可用:
tools/venv/bin/python -I tools/tv.py 'pm list packages' # one shell command on the TV
然后套用某个型号的清理清单,并构建安装新桌面:
tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt # apply a debloat list
TV_HOST=192.168.1.50 launcher/build-and-install.sh # build the launcher and make it Home
常见进阶操作:
- 恢复原状:
tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt会撤销清单,原厂桌面回归。 - 检查固件更新后有哪些改动被还原:
tools/venv/bin/python -I tools/check.py examples/xiaomi-mi-tv-4a/debloat.txt。 - 推送主题:
tools/theme.sh themes/aurora,加--reset移除。 - 覆盖原厂桌面识别:传入
STOCK_LAUNCHER=(PowerShell 为-StockLauncher),或传none表示不动它;FORCE_HOME=1(PowerShell 为$env:FORCE_HOME)可强制禁用清单中的 Home 应用。
README 也提到可以交给编码助手执行,支持 Claude Code、Codex、Gemini CLI 或 Antigravity CLI;关键是克隆本仓库,让助手复用仓库里的 tools/disable.sh 与 launcher/build-and-install.sh,因为备份、Home 保护和恢复记录都在这些脚本里。
适用场景与注意事项
- 适用:任何运行 Android TV 或 Google TV 的设备;README 的实测清单覆盖 TCL、Sony、Xiaomi、Philips、Skyworth、Hisense、Amazon Fire TV、NVIDIA Shield 等大量品牌与型号。
- 不适用:Samsung、LG、Roku 等非 Android TV 设备无法运行,README 建议改用官网
cleanyour.tv/not-android的遥控器手动关闭追踪步骤。 - 联网要求:电脑与电视需在同一 Wi-Fi,且电视需开启网络 ADB(默认端口 5555)。
- Home 风险:脚本只会禁用其识别的原厂桌面,并在清单包含 Home 应用且没有其他应用响应 HOME 时跳过该条目;但如果你手动改过桌面或使用非标准固件,建议先确认
KNOWN_STOCK_LAUNCHERS是否覆盖你的机型。 - 许可证:仓库协议标记为
NOASSERTION,使用或再分发前请自行查看仓库中的许可文件,官方文档未给出更具体的授权说明。 - 域名辨别:官方声明只有
cleanyour.tv与本仓库属于项目,cleanyourtv.com等其他使用该名称的域名并非本项目运营。
项目地址
仓库地址:https://github.com/Gathin23/cleanyourtv
作者/组织:Gathin23
项目主页:https://cleanyour.tv
它是一个把电视去膨胀流程脚本化、并附带可回滚机制与社区型号清单的工具集,适合愿意动手折腾自己电视的 Android TV 用户参考使用。















cqlbgzs@163.com 1年前0
d好879445037@qq.com 2年前0
购买了 无法下载Alexcc 3年前0
强大Alexcc 3年前0
看不了教程Alexcc 3年前0
雷刺下载Alexcc 3年前0
下载Alexcc 3年前0
下载dsa456159 3年前0
下载