
cleanyourtv 是一个用 Python 编写的开源 Android TV / Google TV 精简方案,通过 Wi-Fi 上的 ADB 关闭厂商遥测、广告服务与预装应用,并换上类 Apple TV 风格的主屏启动器,面向不想 root 的电视用户。
cleanyourtv 是一个用 Python 编写的开源 Android TV / Google TV 精简方案,通过 Wi-Fi 上的 ADB 关闭厂商遥测、广告服务与预装应用,并换上类 Apple TV 风格的主屏启动器,面向不想 root 的电视用户。

项目定位与背景
cleanyourtv 要解决的是智能电视出厂后被遥测、广告服务、内容推荐行和预装应用填满的问题。它把 Android 电视当成一台带调试桥的 Android 设备:打开开发者选项里的 USB 调试、在电脑上授权一次,剩下的都是标准 Android 工具链能做的事。
它的技术形态是“提示词 + 命令行步骤 + 一个小型原生启动器”的组合,而不是单个可执行程序。禁用动作使用 pm disable-user 完成,副作用是没有任何应用被卸载,因此随时可以还原;主屏替换则依赖仓库中那个需要自行构建的原生启动器。
据仓库信息,项目主要语言为 Python,主题标签覆盖 adb、debloat、android-tv-launcher、apple-tv、fire-tv、google-tv 等,仓库未标注开源协议。截至发稿,该项目获得 58,317 stars、7,624 forks 和 297 个 open issues。README 特别说明:cleanyour.tv 与本仓库是唯一官方渠道,cleanyourtv.com 等域名不由项目运营,项目也不在任何应用商店发布应用。
核心功能
- 备份:在动手前记录已安装包列表与设置,为后续还原留下依据。
- 禁用:用 pm disable-user 关闭厂商遥测、广告服务、内容行和预装垃圾,全过程中不卸载任何应用。
- 安装启动器:安装一个小型原生启动器并设为默认主屏,得到 Apple TV 风格的主屏体验。
- 一行还原:还原脚本可以撤销上述每一步,用户改变主意后无需刷机。
- 按品牌发现臃肿项:电视厂商的预装内容各不相同,提示词会让编码助手在你的电视上实地发现这些项目,并在触碰你可能要用的应用前先征求确认。
- 免 root、免线缆:全部操作走同一 Wi-Fi 下的 ADB,不需要 root,也不需要插线。
- 非 Android 电视指引:三星、LG、Roku、Vizio、海信 VIDAA 用户可前往 cleanyour.tv/not-android,用遥控器关闭追踪。
安装部署与上手方式
官方路径是让编码助手执行提示词。前置条件在 README 中写明:一台与电视处于同一 Wi-Fi 的电脑、可用的 shell、Python 3、17 至 22 之间的 JDK,以及带 build-tools 34 的 Android SDK platform 34(启动器在该环境构建)。README 称编码助手大约十五分钟可以完成,Claude Code 等助手均可。
电视一侧只需开启 USB 调试并在电脑上授权一次;随后是备份、禁用、安装启动器三步。
没有编码助手时,可按照 README 的“Doing it by hand”一节自行执行同样的命令,其中包含安装命令。既没有电脑也没有助手时,README 指向 cleanyour.tv/app 上的社区应用,这些由独立开发者基于同一批电视清单构建。手机或笔记本用户以及非 Android 电视用户,都不适合走主流程。
适用人群与不适用场景
- 适合:拥有 Android TV 或 Google TV、希望去掉广告与推荐行而不想 root 或刷机的用户。
- 适合:身边有电脑和编码助手、愿意花十几分钟完成一次配置的动手型用户。
- 适合:在意可回退性、需要保留还原脚本以便日后恢复原厂状态的用户。
- 适合:Fire TV 等基于 Android 的电视设备用户,项目主题标签明确覆盖这一类。
- 不适合:三星、LG、Roku、Vizio、海信 VIDAA 等非 Android 电视用户,项目在这些设备上无法运行。
- 不适合:完全没有命令行经验、也没有编码助手,又不愿使用第三方社区应用的用户。
- 不适合:需要官方商业支持或应用商店正式发行版本的用户,项目未在任何应用商店发布应用。
- 不适合:指望“一键安装包”的用户,启动器需要在本地用 JDK 与 Android SDK 构建。
常见问题
Q:cleanyourtv 是什么?
A:它是一个用 Python 编写的开源 Android TV / Google TV 精简项目,通过 Wi-Fi 上的 ADB 禁用厂商遥测、广告服务和预装应用,并安装一个类 Apple TV 风格的原生启动器作为默认主屏。
Q:它是免费的吗?
A:README 没有提到任何收费项,代码公开在 GitHub 上,但仓库未标注开源协议,因此使用与再分发前应先确认授权条款。项目明确不在任何应用商店发布应用,遇到以该名义上架的应用需谨慎。
Q:怎么安装?
A:需要一台与电视同一 Wi-Fi 的电脑,装好 Python 3、JDK 17 至 22 和带 build-tools 34 的 Android SDK platform 34,然后在电视上开启 USB 调试并授权。之后用编码助手执行提示词完成备份、禁用和安装启动器,或按 README 的手动步骤自行执行。
需要在不 root、不卸载、可一键还原的前提下清理 Android TV 或 Google TV 的用户,cleanyourtv 值得一试;它的主要门槛在于必须自备电脑、JDK 与 Android SDK,并愿意跟随命令行或编码助手完成操作。
