ToomRamcharan/tv-vibehack

效率与系统工具

免 root 替换 Android TV 广告桌面,把 Home 键和赞助按钮导向 HDMI 或个人媒体。

303
27
Java
NOASSERTION
上线 5 天

如果你家里有广告多、热键乱跳的 Android TV / Google TV,又愿意用 ADB 折腾,这个项目值得看一眼;想要装完即用的成品应用,或电视不是 Realtek 方案,先别抱太高期待。

解决什么问题

家里老人只想看有线电视、切到某个 HDMI 口,或播放 U 盘里的家庭录像。原厂 Google TV 开机先推赞助横幅和应用推荐,遥控器上的 Netflix、Prime 键还容易误触,一按就跳进订阅页。项目做的事是换掉这个入口:用一个自绘桌面放少量 Dock 图标,同时拦截 Home 键和赞助热键,让它们直达 HDMI 或媒体库。结果是一个更简单的首页,而原厂桌面仍保留在系统里,自定义桌面不在时还能退回去。

有什么不同

关键在于它不去禁用原厂桌面。README 说明,在 Android 14 Google TV 上禁用 com.google.android.apps.tv.launcherx 会破坏 Direct Boot,可能触发 Android 的 RescueParty,导致黑屏恢复状态;因此项目保留原桌面,另加一个 directBootAware 的桌面和一个原生无障碍服务来拦截 Home 键。另一块逻辑是逆向 Realtek 的 TvContract 直通 URI,让桌面能直接切到指定 HDMI 输入,不用在电视菜单里层层点选;同一个服务还把写死的遥控器按键(Netflix、Prime)重映射到这些输入。代价是:它依赖无障碍服务拦截按键,也依赖具体机型的直通 ID,换品牌或固件就可能失效。项目还带一个 U 盘/内置存储媒体查看器,旧格式需要先用 FFmpeg 转成 H.264。

谁值得试

适合:愿意编译 APK、跑 ADB 命令的折腾型用户,想给长辈准备一个干净首页和几个一键入口。README 里的 Acer/Realtek 案例 是具体的起点,也写明了它替换的是哪个桌面包。不适合:希望从应用商店安装、或家里没人能在固件升级后重新 adb 和重编译的人。非 Realtek 电视用户要注意,HDMI 直通部分绑定的是 Realtek 的输入 ID;README 邀请 TCL、Sony、海信等用户提交案例,这更像是征集适配,而不是现成支持。

使用条件与边界

它不是一键产品。你需要能开网络调试的 ADB、能编译 Android 工程的工具链,以及通过系统设置启用无障碍服务的权限。精简预装应用是按机型来的,README 在 examples/ 下给了配置,具体禁用哪些包仍要自己判断。所谓 fail-safe 应理解为“不禁用原厂桌面”,不代表每条 ADB 命令或无障碍设置都无害。后续维护也要算进去:电视固件升级可能改变输入 ID 或按键码,直通和热键部分需要重新核对;媒体播放则要求文件已转码为 H.264 并放进约定目录。

HotRepo 点评

HotRepo 首次记录这个仓库是 2026-10-24,当时它约 5 天;2026-10-25 的新项目榜(Java)显示 303 总星、第 8 名。这是新项目榜的排位,不是日增数据,现有覆盖也不足以判断热度能否持续。真要用之前,先核对 examples/ 里的配置和直通 ID 是否匹配你的电视型号与固件。

本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。