如何10分钟给安卓电视去广告换新桌面:tv-vibehack快速上手完整指南(附ADB调试设置步骤)

原创2026-10-19 21:29:161,843 阅读
文章标签:智能硬件开发工具

如何10分钟给安卓电视去广告换新桌面:tv-vibehack快速上手完整指南(附ADB调试设置步骤)

tv-vibehack 是一个开源的安卓电视去广告工具包:通过 ADB 把 Android TV / Google TV 上的广告推送、厂商遥测和预装垃圾应用批量禁用,并装上一个仿 tvOS 风格的干净电视桌面。全程可逆——所有操作都只是"禁用"而不是"卸载",一条还原脚本就能恢复原样。这篇快速上手指南带你 10 分钟完成智能电视去广告 + 换桌面,附 ADB 调试设置步骤。

tv-vibehack 安卓电视去广告前后对比:左侧是带赞助广告的原始桌面,右侧是干净的 tvOS 风格新桌面

📺 先看效果:广告和推荐位都消失了

原版 Google TV 主界面顶部常年挂着 "Sponsored" 广告横幅,下面还堆满各种推荐内容位,越用越卡:

安卓电视原始桌面:顶部赞助广告横幅加满屏推荐内容位的去广告前状态

而 tv-vibehack 处理后的桌面是:纯黑背景、大号细体时钟和日期、底部 dock 只留你自己选的 4 个应用——没有广告、没有推荐流、没有网络轮询,专为只有 1GB 内存的老电视优化。

tv-vibehack 去广告后的新桌面:纯黑背景加 tvOS 风格 dock 栏的无广告安卓电视启动器

🔧 第一步:ADB 调试设置步骤(电视上操作约 2 分钟)

  1. 电视上进入 设置 → 设备偏好 → 关于,连续按 OK 键 7 次 "Build(版本)"
  2. 返回上一级,进入 开发者选项,打开 USB 调试(如果看到"网络/ADB 调试",一并打开)
  3. 记下电视的 IP 地址("设置 → 网络"里可见),确保电脑和电视连着同一个 Wi-Fi,电视保持开机

💡 小技巧:有些电视(如小米)没有"无线调试"开关,但只要开了 USB 调试,网络 ADB(5555 端口)就已经自动打开了。

🚀 第二步:最快方法——把提示词交给 AI 编程助手

git clone https://gitcode.com/gh_mirrors/tv/tv-vibehack
  1. 打开 Claude Code(或任意能执行命令的编程助手),粘贴 PROMPT.md 里的提示词,把 <MODEL NAME HERE> 换成你的电视型号
  2. 电视弹出 "Allow USB debugging?" 时点允许
  3. 回答 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 校验

安卓电视桌面去广告改造前后对比图:上为带广告的原始桌面,下为 tv-vibehack 换装后的新桌面

✨ 新桌面长什么样: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 命令即可全部还原。快去给你的电视做一次"大扫除"吧!

登录后查看全文
cleanyourtv