ecklf/lg-luma
效率与系统工具为已 root 的 LG webOS 电视提供原生启动器,替代原生主页并让桌面更接近 Apple TV。
如果你已经把 LG 电视 root,并且觉得自带主页广告多、层级乱,Luma 值得看一眼;但要先确认自己的型号能不能接管主页,接管方案也需要手动配置。
解决什么问题
在已 root 的 LG 电视上,日常流程是:开机、等 webOS 自带主页加载、略过推荐内容、再翻到想用的应用。已经装了 Homebrew Channel 的用户想要一个更干净的入口,把常用应用和输入源放在前面。Luma 用原生启动器替换这个落点,开机后进入自己定制的主页,应用启动仍然交给电视自己的应用管理服务。
有什么不同
Luma 用 Rust 编写并原生渲染,不走网页外壳,这是 演示视频 里操作跟手的基础。它会读取电视上已安装的应用清单,支持收藏和隐藏应用,提供输入源设置和简单天气,状态保存在应用自己的持久目录里的本地 JSON 文件。天气请求发往 Open-Meteo,README 明确说没有浏览器地理定位、没有基于 IP 的定位、没有遥测,也不在运行时下载字体。
代价是替换 LG 主页并不是一个开关。README 给出三种方式:webOS 5、6、25、26 上的接管方式;接管关闭时用的自启动脚本;以及通过 LG Input Hook 映射按键。接管并不会删除 LG 主页,它只是被临时挂载挡住,重启后就恢复。但如果先卸载 Luma,遗留的启动钩子会因为找不到 Luma 而报错,因此干净卸载要先关闭接管再卸载。自启动方式把 Luma 当普通应用启动,不重映射 Home 键。
谁值得试
适合已经 root 的 LG 电视用户,想要类似游戏主机的主页界面,愿意用 SSH 和命令行,并且能接受逐个型号确认主页接管是否可用。README 的兼容表列出已验证机型和接管支持情况:支持、不支持或未知;标为不支持或横线的机型不适合走接管路线。
不适合完全不想维护的人:每种方案要么依赖启动钩子,要么依赖改按键,切换方案时还要先关掉旧方案。也不适合未 root 的电视,因为安装依赖 Homebrew Channel 或 root SSH。
使用条件与边界
硬性条件是已 root 且系统为 webOS 4 或更新,并使用文档给出的安装路线:Homebrew Channel 或 root SSH 安装命令。webOS 4 被列为可启动范围,但主页接管只支持 5、6、25 和 26,老机型可能需要改用自启动或 Input Hook 方式。
后续维护比首次安装更重要。README 提醒原生调用权限和生命周期行为可能因固件而异,并且 LG Input Hook 里的 Home 键映射要先清掉或先在备用按键上测试。动手前先对照兼容表确认自己的型号标识符,并想清楚能长期接受哪种替换方式,因为换方案意味着先把旧方案撤掉。
HotRepo 点评
HotRepo 在 2026-10-27 记录到 192 个总 star,以及新项目榜(Rust)第 21 名;这只是单日快照,不是增长序列,无法判断热度能否持续。项目创建于 2026-10-19,至今仅一周左右。安装前最值得确认的是具体型号是否出现在主页接管兼容表里,以及 README 对该机型推荐哪种方式。
本文由 AI 根据项目 README 生成,更新于 2026年10月27日,以项目官方文档为准。