如何10分钟给安卓电视去广告换新桌面:tv-vibehack快速上手完整指南(附ADB调试设置步骤)
如何10分钟给安卓电视去广告换新桌面:tv-vibehack快速上手完整指南(附ADB调试设置步骤)
tv-vibehack 是一个开源的安卓电视去广告工具包:通过 ADB 把 Android TV / Google TV 上的广告推送、厂商遥测和预装垃圾应用批量禁用,并装上一个仿 tvOS 风格的干净电视桌面。全程可逆——所有操作都只是"禁用"而不是"卸载",一条还原脚本就能恢复原样。这篇快速上手指南带你 10 分钟完成智能电视去广告 + 换桌面,附 ADB 调试设置步骤。
📺 先看效果:广告和推荐位都消失了
原版 Google TV 主界面顶部常年挂着 "Sponsored" 广告横幅,下面还堆满各种推荐内容位,越用越卡:
而 tv-vibehack 处理后的桌面是:纯黑背景、大号细体时钟和日期、底部 dock 只留你自己选的 4 个应用——没有广告、没有推荐流、没有网络轮询,专为只有 1GB 内存的老电视优化。
🔧 第一步:ADB 调试设置步骤(电视上操作约 2 分钟)
- 电视上进入 设置 → 设备偏好 → 关于,连续按 OK 键 7 次 "Build(版本)"
- 返回上一级,进入 开发者选项,打开 USB 调试(如果看到"网络/ADB 调试",一并打开)
- 记下电视的 IP 地址("设置 → 网络"里可见),确保电脑和电视连着同一个 Wi-Fi,电视保持开机
💡 小技巧:有些电视(如小米)没有"无线调试"开关,但只要开了 USB 调试,网络 ADB(5555 端口)就已经自动打开了。
🚀 第二步:最快方法——把提示词交给 AI 编程助手
git clone https://gitcode.com/gh_mirrors/tv/tv-vibehack
- 打开 Claude Code(或任意能执行命令的编程助手),粘贴 PROMPT.md 里的提示词,把
<MODEL NAME HERE>换成你的电视型号 - 电视弹出 "Allow USB debugging?" 时点允许
- 回答 3~4 个勾选题:常用哪些流媒体应用、dock 栏放哪 4 个、要不要保留语音助手和 Chromecast
之后助手会自动完成:备份 → 去广告 → 编译并安装启动器 → 逐步骤截图验证。你只需要在沙发上看结果。
🛠️ 不想用 AI?手动去广告也只要几条命令
仓库里的工具是纯 Python 实现,不依赖 adb 二进制(能绕开 macOS 对 adb 的拦截):
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
--probe 会打印电视型号、Android 版本和固件,方便对照。然后应用一份现成的去广告清单(以 examples/xiaomi-mi-tv-4a/debloat.txt 为例,已按厂商遥测、PatchWall 广告、预装应用分组并写好注释):
TV_HOST=192.168.1.50 tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt
| 工具 | 作用 |
|---|---|
| tools/tv.py | 纯 Python ADB 客户端:单条命令、--batch 批量命令、文件 push/pull |
| tools/disable.sh / tools/restore.sh | 一键应用 / 撤销去广告清单 |
| tools/b64push.py | 大文件(APK)base64 分块上传,带 md5 校验 |
✨ 新桌面长什么样:tvOS 风格启动器
启动器源码在 launcher/,为 1GB 内存电视设计:纯黑背景、底部浅色圆角 dock 放 4 个自选应用、按"下"键滑出完整应用网格、一块半透明"玻璃"高亮在图标间弹跳、右上角毛玻璃胶囊按钮(输入源 / Wi-Fi / 设置)。无模糊、无视频、无网络请求、无后台服务。
个性化只需改一个文件 launcher/app/src/main/res/values/config.xml:dock 顺序、隐藏应用、Live TV 包名、网格列数。然后执行:
TV_HOST=192.168.1.50 launcher/build-and-install.sh
(需要 JDK 17 + Android SDK platform 34)
⚠️ 常见坑与解决办法
| 症状 | 解决办法 |
|---|---|
macOS 上 adb connect 报 "No route to host" |
新版 macOS 本地网络隐私策略会拦 adb,直接用 tools/tv.py 绕过 |
| 换桌面后没有键盘 | 默认输入法指向了未安装的包,执行 tools/tv.py 'ime set com.google.android.inputmethod.latin/com.android.inputmethod.latin.LatinIME' |
| 按 Home 键进了工厂测试页 | 必须装好新启动器之后再禁用旧启动器,顺序别反 |
连写的 pm 命令只执行了第一条 |
pm 命令要一条一个 shell 调用,--batch 已自动处理 |
📋 支持范围与安全性
- ✅ Android TV / Google TV:Xiaomi/Redmi、TCL、Hisense、Sony、OnePlus、Realme、Nvidia Shield 等
- ❌ 不支持 Samsung Tizen、LG webOS、Fire TV(系统不同,无法换启动器)
- 🔒 全程可逆:只用
pm disable-user禁用,从不卸载系统包;运行 tools/restore.sh 即可恢复系统启动器和所有被禁用的应用:
TV_HOST=192.168.1.50 tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt
🎯 10 分钟流程回顾
开开发者选项(2 分钟)→ 粘贴提示词交给助手(5 分钟)→ 回答勾选题并等待验证(3 分钟)。广告没了,桌面干净了,想反悔时一条 restore 命令即可全部还原。快去给你的电视做一次"大扫除"吧!



