GitHub 热门项目推荐:cleanyourtv(Python|39295 Star)

这个项目有什么用

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」整理。

  1. 创建虚拟环境并安装依赖:
    python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
  2. 设置电视的 IP 地址环境变量(把示例地址换成你自己的):
    export TV_HOST=192.168.1.50                                   # your TV's IP address
  3. 探测电视信息,确认连接正常:
    tools/venv/bin/python -I tools/tv.py --probe                 # model, Android version, firmware
  4. 如果 5555 端口不通、电视提供的是带配对码的无线调试(如 Chromecast with Google TV 与 Google TV Streamer),先用原版 adb 配对一次,再执行 adb tcpip 5555,具体见 docs/TROUBLESHOOTING.md#connecting。
  5. 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 用户参考使用。

© 版权声明
THE END
喜欢就支持一下吧
点赞7 分享