0xProbabillity/luma-tv

效率与系统工具

给 Android TV 和 Google TV 换一个安静、无广告、只显示自选应用的主屏。

104
11
Java
MIT
上线 5 天

如果你用的是 Android TV 或 Google TV,又受够了自带首页里的推广行,Luma 值得花半小时试一下。它是一个用纯 Java 写的小型替换桌面,以侧载 APK 形式发布,没有应用商店安装和自动更新。

解决什么问题

多数 Google TV 和不少 Android TV 机型的首页,会把自己的应用和赞助推荐混在一起,用户很难完全关掉。想看 Netflix 或本地播放器,得先扫过别人挑好的内容。Luma 把这一屏换成问候语、大号应用卡片和自选小组件,打开电视第一眼只有你放上去的东西。改变的是开机后的首页本身,而不是某个偶尔打开的 App。

有什么不同

README 描述的设计借鉴 tvOS 的安静感:日期问候、圆形场景按钮、带景深的壁纸和一排收藏应用,按住 OK 可以置顶、移动或隐藏。应用上方可选的小组件里,Up Next 来自 YouTube、Netflix 等应用通过 Android TV 共享的“继续观看”列表。场景按钮和 3D 预览是例外,不是核心:只有同一台电视上装了 House Control 这个智能家居应用时才可用。

隐私方面 README 写得明确:没有分析统计、没有广告 ID、不用无障碍服务、不需要账号,设置只留在电视上。联网只用于 Open-Meteo 天气、继续观看列表里的海报图,以及本机 127.0.0.1 上的 House Control。代价是这是一个轻量的个人项目,不依赖第三方库;问候语默认值和首次排序等定制,多半要通过安装参数或改源码完成,而不是一个功能齐全的设置界面。

谁值得试

适合只有一台 Android TV 盒子或电视棒、同一网络里有电脑、并且愿意用 ADB 装 APK、之后也能接受撤销桌面切换的人。想要干净的首屏、不需要智能家居场景,任何 Android TV 都能覆盖。不适合期待应用商店安装和自动更新的人,也不适合没法用电脑通过网络连到电视的人。核心首页不需要 House Control,只有场景按钮和 3D 预览需要。

使用条件与边界

电视需要 Android 8.0 以上,并打开 USB 或网络调试;电脑需要 macOS 或 Linux 以及 ADB。从源码构建还需要 JDK 17、Android SDK build-tools 36.0.0、platform android-34 和 Python 3,但不用 Gradle。这个准备成本是主要门槛,README 没有给出在电视上直接安装的方式。README 里的安装说明和发布页 APK分别对应两条安装路径。

自己构建会在 .signing/ 生成签名密钥,必须保留,否则用别的密钥签名的更新会被 Android 拒绝。Releases 里的 APK 用项目自己的密钥签名,所以在官方包和自编译包之间切换要先卸载。把 Luma 设为默认桌面依赖 ./luma.sh home,它会用 pm disable-user 停用已知的原厂桌面,同时保留其数据;README 写了回到电视自带桌面的方法,改之前应先读这段。日常维护也落在你身上:每次更新都要重新通过 ADB 连接并安装。

HotRepo 点评

HotRepo 的记录从 2026-10-24 开始,唯一有日期的信号是 2026-10-25 在 Java 新项目榜(不是总榜)排到 #16、共 104 个 star。这只是一个快照,不是每日增长数据,目前还无法判断关注度能否持续。决定之前,先仔细看 ./luma.sh home 那节,确认回到原厂桌面的方式与你的电视型号相符。

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