已收录469 条资讯/102 个 AI 工具/417 个开源项目/75 个学习资源
首页资讯开源榜单模型榜AI 工具Skills学习资源
首页 / 开源榜单 / cleanyourtv

cleanyourtv

通过 Wi-Fi 移除 Android TV 和 Google TV 中的预装臃肿软件、广告与遥测，并安装轻量级 Apple TV 风格启动器，无需 root，完全可逆。

JavaNOASSERTIONApplication
⭐ GitHubhttps://github.com/Gathin23/cleanyourtv
30,126
Star 数
+0
Star 增速
2026年10月24日
最后更新
11
点击数

1. 项目概述

CleanYourTV 是一款面向 Android TV 和 Google TV 的开源工具包，可通过 Wi-Fi 移除预装的臃肿软件、广告和遥测功能，并用轻量级的 Apple TV 风格启动器替换原生主屏幕——无需 root、无需数据线、不卸载任何应用，且支持一行命令恢复。

2. 背景与定位

创建初衷

许多智能电视出厂时预装了应用、推广内容栏、广告服务以及后台遥测功能，不仅拖慢设备运行速度，还让主屏幕显得杂乱无章。CleanYourTV 为电视所有者提供了一种安全、可逆的方式来掌控自己的电视，仅使用用户本就有权更改的设置（内置 ADB 调试）。

与同类项目的区别

  • 设计上完全可逆： 使用 pm disable-user 禁用应用而非卸载，并通过记录快照实现一条命令即可恢复。
  • 识别设备差异： 精简列表因品牌而异，因此编程助手会先检查你的具体电视型号，并在进行任何更改前征求确认。
  • 自带启动器： 精简操作与替代主屏幕集成在同一个项目中（约 497 KB，纯 Java 编写，可在 1 GB 内存的电视上运行）。
  • 社区验证的列表： examples/ 文件夹中收录了用户贡献的各机型精简列表（涵盖 170 多款机型）。

3. 功能分类

🧹 精简与广告移除

无需 root 即可禁用遥测、广告服务、内容栏和预装应用。

  • 备份已安装的应用包列表与设置
  • 基于 pm disable-user 的禁用方式（不卸载任何内容）
  • 安全检查：在未提供替代方案时拒绝禁用当前使用的主屏幕应用
  • check.py 用于检测被固件更新恢复的应用包（添加 --fix 可重新应用配置）
  • 根据记录的状态一键恢复

📺 轻量级启动器

专为 Android TV 和 Google TV 打造的快速、极简替代主屏幕。

  • 黑色背景搭配收藏栏与应用网格
  • 顶部展示区显示当前聚焦应用的名称
  • 玻璃质感焦点高亮与毛玻璃效果按钮（输入源、网络、设置）
  • 时钟屏保，可选显示 CPU、内存和存储状态
  • 支持 25 种语言，包含镜像式从右向左布局

🎨 主题与自定义

无需重新构建启动器即可个性化外观。

  • 可配置颜色、壁纸、停靠栏和列数
  • 内置主题，如 default、aurora 和 six-columns
  • 使用 tools/theme.sh 应用主题
  • 遥控器按键重映射与应用库（可选）

🧩 附加组件与模块卡片

通过可选应用扩展启动器功能。

  • 其他应用仅在获得用户许可后才能添加磁贴
  • 附加组件存放在 addons/ 文件夹中
  • cleanyour.tv 网站提供应用与附加组件的配套页面

🔒 隐私与安全工具

了解并减少电视在后台执行的操作。

  • privacy.py 会报告语音、ACR 和遥测相关候选项并提供证据
  • adb-closed.py 用于确认操作完成后网络 ADB 端口已关闭
  • 可选配置 AdGuard DNS，通过私人 DNS 屏蔽应用内广告
  • 可选使用 Tailscale 进行安全的远程管理

🛠️ 开发者与诊断工具

供维护者和贡献者使用的实用工具。

  • tv.py：纯 Python 实现的 ADB 客户端与探测工具
  • bench.py、trace.py 和 screendiff.py：用于性能与视觉检查
  • manage.py：用于设备管理
  • tests/ 中包含测试套件

4. 核心亮点

  • 无需 root，无需数据线： 利用电视内置的网络 ADB 调试功能，通过 Wi-Fi 即可运行。
  • 完全可逆： 不卸载任何内容，基于快照的恢复功能可将电视还原至先前状态。
  • AI 辅助工作流： 将 PROMPT.md 粘贴到 Claude Code、Codex 或 Gemini CLI 等编程助手中，它会在约十五分钟内引导你完成整个清理过程。
  • 超小启动器： 约 497 KB，纯 Java 编写，面向 Android 8.0（API 26）及以上版本。
  • 广泛的社区覆盖： 针对 TCL、索尼、小米和飞利浦等品牌的 170 多款电视机型提供了经过测试的精简列表。
  • 默认全球化： 支持 25 种界面语言，README 提供日语、越南语和简体中文翻译。

5. 适用角色与场景

  • 普通用户与电视所有者： 在无技术风险的前提下获得更快速、更清爽的主屏幕。
  • 普通开发者： 学习一个紧凑的原生 Android TV 启动器和纯 Python ADB 客户端。
  • DevOps / SRE： 使用脚本和 Tailscale 远程管理大批量电视或信息亭设备。
  • 安全工程师： 使用 privacy.py 审计遥测、语音和 ACR 候选项，并验证操作后 ADB 是否已关闭。
  • 项目经理 / 集成商： 使用共享的精简列表部署统一、无广告的数字标牌或酒店显示屏。

6. 快速入门

查找所需内容

浏览 examples/ 中的各机型列表和 docs/ 中的指南，或访问 https://cleanyour.tv。

安装 / 集成

  1. 在电视上开启开发者选项和 USB 调试，并确保其与电脑连接同一 Wi-Fi 网络。
  2. 将 PROMPT.md 粘贴到编程助手中并输入你的电视型号，或手动运行以下命令：
git clone https://github.com/Gathin23/cleanyourtv.git
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/<model>/debloat.txt
TV_HOST=192.168.1.50 launcher/build-and-install.sh
tools/theme.sh themes/aurora

撤销所有更改：

tools/restore.sh examples/<model>/debloat.txt

也可以使用社区开发的 Android 应用，直接通过手机完成清理，无需电脑。

参与贡献

将你测试过的电视机型精简列表添加到 examples/ 中，然后阅读 CONTRIBUTING.md 并提交拉取请求：https://github.com/Gathin23/cleanyourtv/blob/main/CONTRIBUTING.md

7. 项目结构

cleanyourtv/
├── addons/        # 以模块卡片形式展示的可选附加应用
├── docs/          # 指南、规范、故障排查、设备说明
├── examples/      # 各机型的精简列表
├── launcher/      # Android 启动器源码与构建脚本
├── themes/        # 主题文件夹（default、aurora、six-columns 等）
├── tools/         # Python/shell 工具（tv.py、disable.sh、restore.sh、check.py、privacy.py）
├── tests/         # 测试套件
├── PROMPT.md      # 用于编程助手驱动配置的提示词
├── CONTRIBUTING.md
├── SECURITY.md
└── LICENSE

8. 相关生态

  • Android Debug Bridge (ADB)： 用于控制电视的机制。
  • 编程助手： Claude Code、Codex 和 Gemini CLI 均可驱动引导式配置流程。
  • 构建工具链： 启动器使用 JDK 17 以及带 build-tools 34.0.0 的 Android SDK platform 34。
  • 可选服务： Tailscale（远程管理）和 AdGuard DNS（广告屏蔽）。
  • 相关平台： Fire TV 仅支持精简功能；三星（Tizen）和 LG（webOS）属于不同系统，由单独的文档说明。

9. 许可证

  • ✅ 根据 MIT 许可证条款（如项目 README 所述），可使用、复制、修改和分发本软件，包括商业用途
  • ✅ 可将其纳入你自己的项目，但需保留许可证声明
  • ❌ 不提供任何保证；作者不对损害承担责任
  • ❌ 与任何电视制造商均无关联，也未获其认可
  • ℹ️ GitHub 将该许可证显示为未识别（NOASSERTION）；请查看仓库中的 LICENSE 文件
  • ℹ️ Outfit 字体采用 SIL Open Font License

10. 常见问题

问：它安全吗？可以撤销吗？
答：应用只会被禁用，绝不会被卸载。运行 tools/restore.sh examples/<model>/debloat.txt 即可恢复。

问：支持 Fire TV、三星或 LG 电视吗？
答：Fire TV 仅支持精简功能。三星（Tizen）和 LG（webOS）是不同系统，不受直接支持。

问：固件更新会撤销这些更改吗？
答：更新可能会重新启用某些应用包。运行 check.py 查看变化，并添加 --fix 重新应用你的列表。

问：可以不用电脑操作吗？
答：可以，社区开发的 Android 应用能通过手机执行相同的清理操作。

问：完成后需要保持 ADB 开启吗？
答：不需要。网络 ADB 在 5555 端口上未加密；完成后请将其关闭，并使用 adb-closed.py 验证。

11. 快速链接

12. 总结

CleanYourTV 为电视所有者提供了一种安全、可逆的方式，通过 Wi-Fi 且无需 root 即可移除臃肿软件、广告和遥测功能，并安装快速清爽的启动器。它适合所有希望获得更快速、更安静主屏幕的 Android TV 或 Google TV 用户，也适合想要学习或扩展紧凑且文档完善的代码库的开发者与安全工程师。