mbsintegrations/LG-TV-HA-Home-Launcher
运维与部署把 LG webOS 电视变成 Home Assistant 仪表盘,可在本地生成带配置的 IPK,并可选装主页键助手。
如果你本来就在用 Home Assistant,又想让电视开机后直接显示自己的仪表盘,这个项目值得看一眼。先想清楚代价:它是侧载应用,必须开启电视的开发者模式,而且每次改配置都要重新打包和安装。
解决什么问题
电视开机后,你希望看到 Home Assistant 里的温度、控制和能源数据,而不是 LG 默认的首页和应用推荐。原来的做法要么每次手动在电视上打开浏览器,要么接受电视自带首页。这个项目改变了配置流程:你在电脑上通过本地浏览器向导选择布局、发现并绑定 HA 实体,生成一个带自己配置的 IPK,再安装到电视。装好后电视应用直接连接现有的 HA 实例,首页由应用图标、控制项、温度、状态行和能源卡片组成。
有什么不同
它的核心机制是“本地打包”。向导在 Windows、macOS 或 Linux 上运行,读取 HA 实体后把配置写进安装包;电视上没有设置编辑器,启动器配置也不要求用户编辑 YAML。布局配置可以导出和导入,且不含凭据,一个配置对应一台电视。因为配置存在安装包内,而不是依赖浏览器存储,更新布局就必须重新生成并重新安装,电脑也每次都要参与。这是有意设计的取舍,换来的是升级应用包时配置不丢。装好之后,电脑可以收起来,电视应用自己跟 HA 通信。
另一个值得注意的是无广告首页,但 README 明确说明它不改变 LG 原有的隐私和数据收集设置,不要把“无广告”理解成隐私保护。基础应用也不会接管 LG 主页键;另有单独的“无 root”助手,可从 YouTube 等应用返回启动器,但它取决于具体机型,而且是一个原生程序加 JavaScript 控制器/服务,不是通用脚本。
谁值得试
适合已经运行 Home Assistant、想让电视默认界面变成家庭仪表盘,并且愿意侧载电视应用的人。README 记录了在 OLED65B9PLA(SDK 4.10.0)和 65NANO766QA(SDK 7.6.0)上的安装,两者都确认能显示实时 HA 数据并从 YouTube 返回;43UN73906LE 有用户验证“全部功能,包括主页键助手”,但未报告固件和 webOS 版本。如果你只接受 LG 应用商店安装、想要电视上的设置界面,或者不愿意开启开发者模式,这个项目不适合。主页键助手是可选的高级项,可以先用基础应用。
使用条件与边界
开发者模式是硬条件,而且会话必须保持有效。README 建议用随附的 HA 续期包、复用已有的 Camera Overlay 续期,或在到期前手动延长;这是持续维护,不是一次性的安装步骤。电脑上需要 Node.js 22 或更新版本,且项目要解压到非共享、非云同步的目录。兼容性证据只覆盖两台开发测试电视和一台用户验证机型,其他电视型号没有保证,主页键助手尤其要看机型支持。
HotRepo 点评
项目创建于 2026-10-23,2026-10-25 出现在 HotRepo 的 JavaScript 新项目榜第 18 名,总计 74 stars。这是新项目榜的快照,不是单日增长,而且目前只有一个榜单日期,无法判断热度能否持续。决定安装前,最该核对的是你的 webOS 型号是否出现在兼容性说明里,尤其是打算使用主页键助手时。
本文由 AI 根据项目 README 生成,更新于 2026年10月25日,以项目官方文档为准。