OmkarK97/webos-vibehack

采用建议：如果你有受支持的 LG 电视、同一网络下有 Mac，并且接受分两步安装以及用另一台设备常开来接管 Home 键，这个项目值得折腾；它不是零配置启动器。

解决什么问题

你希望电视一打开就是自己挑的 App 停靠栏，而不是 LG 首页里混着推荐和推广的内容。webOS 上装好的启动器能打开，但按 Home 仍会回到 LG 首页，而且开发者模式 App 读不到电视里已安装的应用列表。于是流程拆成两半：电脑读取应用和图标，打包安装启动器。配对完成后，得到的是一个可以在电视上拖动排序、顺序保存在电视里的自定义首页。

有什么不同

界面设计沿用 tv-vibehack 的 Android TV 启动器：四个 App 的停靠栏、按聚焦颜色发光、可滚动的应用网格，以及顶部的输入源、Wi-Fi 和设置入口。webOS 移植版把 ADB 换成 LG 开发者模式 App 和免费 LG 开发者账号，并附带 sync-apps.py，从电视把应用和图标同步到电脑，因为 webOS 不允许已安装的 App 自己枚举应用。

Home 键是最有意思的取舍。webOS 把 Home 写死指向 LG 首页，所以项目提供 home-watch.py，在同网络的另一台常开设备上监视电视前台应用，LG 首页一出现就把启动器盖上去。三秒内连按两次 Home 可以留在 LG 首页。监视器没运行时，Home 照常打开 LG 首页。也就是说，启动器本身可用，但完整的 Apple TV 式体验依赖第二台设备；Mac 只在唤醒且在家时有效，README 建议用树莓派这类常开设备。项目没有 root，但这不等于安装没有后果：开发者模式会话会过期，README 说 App 打不开时要到电视上点 Extend Session Time。

谁值得试

适合：有 Mac、愿意碰终端、想要更干净应用网格，并且不介意增删电视 App 后重新运行安装的 LG OLED 用户。有树莓派的人收益更大，因为 Home 监视器可以一直运行。不适合：只想要一个设置开关、没有 Mac，或者以为不改动第二台设备就能改掉 Home 键的人。README 给出的安装路径目前仅限 macOS，install.sh 用 sips 生成图标；换电脑需要自己改这一步。初次使用还要配置 app/config.js 并与电视配对。

使用条件与边界

需要一台与电视同一 Wi-Fi 的 Mac、Node.js（用来通过 npx 拉取 LG 的 ares CLI）和 Python 3。安装要免费 LG 开发者账号、开发者模式 App、开启 Dev Mode Status 和 Key Server，并在电视上接受配对提示。日常维护也要算进去：电视增删 App 后要重新运行 install.sh，开发者模式会话到期前要去续期。Home 跳转需要第二台常开设备；macOS 还要给 Python 开本地网络权限，否则监视器会提示无法连接电视。

兼容性证据很窄：启动器只在 LG OLED C6（OLED55C6XLA，webOS 26，固件 43.21.79）上测试过，README 也提醒不同 webOS 版本菜单名称略有差异。较新固件可能拒绝开源 LG 客户端共用的签名清单，项目的 lgtv.py 改用未签名清单来配对，所以配对失败可能来自固件而不是操作失误。同步应用数据也意味着电脑对电视有较宽的连接权限，你需要能接受配对提示所允许的范围。

HotRepo 点评

HotRepo 在 2026-10-25 的新项目榜（JavaScript，非总榜、非日增）记录到 #22，总星数 284、Fork 38；这不是 Trending 总榜排名，也不是单日增长。仓库创建于 2026-10-19，项目和已有记录都只有几天，热度能否持续无法判断。安装前请先核对电视的 webOS 版本和固件是否与测试环境一致，或确认故障排查说明覆盖你的配对情况。