* 戳上方蓝字“开源先锋”关注我
大家好啊,我是开源君!
想必大家应该很烦打开现在的电视吧,倒不是说没有啥内容可看。
而是各种的推荐、会员试用、各种"发现",哪哪都是防不胜防,烦都烦死了。
屏幕是我们买的,主页却成了厂商的广告位。
最近 GitHub 上有个有意思的热门项目 - CleanYourTV。
缘由是作者老哥抱怨父母的小米电视太烦人。
于是他用 Claude Code 做了一通整顿:Wi-Fi 连上电视、关掉广告包、换上干净启动器,主屏瞬间清爽了,看起来和 Apple TV一样了。
项目简介
CleanYourTV是一个开源工具,能通过 Wi-Fi 给任何安卓电视(Android TV/Google TV)"去广告、去预装",再换上一个 Apple TV 风格的极简主页。
不 root,不刷机,不拆机,不用数据线。全程走 Wi-Fi。
工作原理也不复杂。安卓电视和安卓手机一样,自带 ADB 调试通道。打开电视的 USB 调试后,就是一个标准安卓工具:
备份:先记下已装应用清单和系统设置 禁用:用 pm disable-user关掉厂商的遥测、广告服务、内容推荐和预装垃圾安装:装上一个小巧的原生启动器,设为默认主页
不同品牌的预装软件不一样。所以项目没有写死名单,而是写了一份提示词(PROMPT.md),让你的 AI 编程助手自己去电视上发现、清理,遇到你可能在用的应用还会先问你。
开源仅仅3天在 GitHub 上就狂揽 1w+ Star。
它还登上了 TechCrunch、Mashable、It's FOSS 等多家海外科技媒体。
功能特性
01 动手之前先记账,一个脚本全部退回
很多人不敢动电视,很多是怕搞坏。CleanYourTV 在这点上做得很稳。
动手之前,脚本会先记录每个包的状态、原来的主页是谁、动画缩放值,存在本地。想还原时,跑一下 restore.sh,一切回到原样。
你自己提前禁用的包,还原时也不会被"误恢复"。
02 Apple TV 风格的极简主页
新主页是纯黑背景,底部是圆角 Dock,放你最常用的 4 个应用。聚焦哪个应用,顶部就用大字显示它的名字,背景还会泛起和它图标同色系的柔光。
其余应用排成网格,按"下"键滑出来。一块磨砂玻璃高亮在图块间弹性滑动,选中的图块会微微抬起。
右上角有三个磨砂按钮:输入源、网络、设置。输入源里的 HDMI 口,会显示你在电视里起的名字。
03 给老电视减负
这个启动器是专门为 1GB 内存的电视设计的。
它用纯 Java 写成,不用模糊效果,不放视频,不联网,没有后台服务。
对那些屏幕不错、芯片很弱的电视,这点特别重要。官网上不少用户反馈,改完之后"流畅了一倍""像换了新电视"。
04 主题、模块卡和时钟屏保
想换个风格?主题不需要重新编译,改一份 config.json 推到电视上就行,能换颜色、壁纸、Dock 和列数。项目自带 4 套主题。
还有模块卡,让其他应用能在主页上"挂"一个自己的磁贴。不过每个应用要不要显示,由你说了算,默认是隐藏的。
另外有个时钟屏保,一个细细的时钟在柔光上缓慢漂移,OLED 电视也不怕烧屏。
05 玩出花的社区
官网有一面"On Air"墙,收了各路网友的改造成果。
有人把电视做成 PS5 风格,有人换上了自拍照轮播,有人在主页上放了 Polymarket 赔率图表。还有人把应用做成书架上的书,打开时会播放 3D 翻书动画。
有人把 Fire TV 改得像 Wii,有人在主页上塞了 NES 复古小游戏。
官网上这类案例已经有 18 个。项目文档里还提到了 LG webOS 的移植版。
快速安装、使用
你需要: 一台和电视在同一个 Wi-Fi 下的电脑,一个能执行命令的 AI 编程助手(Claude Code、Codex、Gemini CLI 都行)。
开始之前可以先查一下TV型号,看看是否有前人摸索好的可以参考。
仓库 examples/ 里有 93 台电视的现成清单,TCL 18 个、Sony 16 个、小米 15 个、飞利浦 6 个、海信 5 个,投影仪、电视盒子也在内。
如果没有也没事,按下面的方式摸索就好了。
第 1 步,在电视上开调试。
设置 → 设备偏好设置 → 关于 → 在"版本号"上连按 7 次 → 返回 → 开发者选项 → 打开 USB 调试。
如果还有"网络调试"或"ADB 调试"开关,一起打开。电视保持开着。
第 2 步,在电脑上开干。
把仓库里的 PROMPT.md 全文粘给助手,填上你的电视型号。
第 3 步,跟着回答。
电视上会弹"允许 USB 调试吗",点允许。
然后助手会问你几件事:常用哪些 App、dock 里放哪四个、语音助手和 Chromecast 留不留、系统更新关不关。
剩下的它自己来:备份、停用、编译、安装、切 Home,每一步都从电视上截图核对。
想手动自己跑也没问题, 工具只要 Python 3:
python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50# 换成你电视的 IP
tools/venv/bin/python -I tools/tv.py --probe # 型号、安卓版本、固件
tools/venv/bin/python -I tools/tv.py 'pm list packages' # 在电视上跑一条 shell
tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt # 套用一份清单
tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt # 撤销,原桌面回来
TV_HOST=192.168.1.50 launcher/build-and-install.sh # 编译桌面并设为 Home
tools/theme.sh themes/aurora # 推一套主题,--reset 撤掉
小提醒:
用完后,记得到电视开发者选项里把 USB 调试和网络调试关掉,网络 ADB 是明文传输的
开源君想说
CleanYourTV把"电视被广告绑架"这件事,变成了一个下午、一条提示词就能解决的小事,而且随时能反悔。
开源君觉得最妙的是,它不是一个"软件",更像一份"和 AI 协作的配方"。作者开了个头,网友们提交了 90 多款电视的清单,两百多个 PR 被合并。
要是你家的电视也被广告和卡顿折磨过,或者爸妈的电视总是点不明白,周末不妨试试。动手前,记得先把 restore.sh 的用法看一眼。
https://github.com/Gathin23/cleanyourtv
又一个宝藏画图 Skill,329 种画风,像翻字典一样用!
1.1w Star!手里没有 Mac 电脑,也能做 iOS 开发了!