rorygallagher2024/glasshouse

项目介绍

Glasshouse 是一个直接运行在已 root 的 LG webOS 电视上的小型服务，提供浏览器仪表盘和电视端应用。它面向希望拿回电视控制权的用户：遥控、应用安装与卸载、隐私与遥测开关、工程菜单、硬件与 OLED 面板遥测，以及接入 Home Assistant 的 MQTT 桥接，都集中在一个本地界面里，不必再依赖 LG 自带菜单、厂商服务和云依赖（README）。

所有处理都在本地完成，电视端不依赖云服务。项目另有一个 Android 伴侣应用，用于管理多台电视、通过 Wake-on-LAN 唤醒并全屏打开各自的仪表盘。

快速使用

前置条件：电视已 root 并安装 Homebrew Channel，电脑与电视处于同一网络。

1. 在电脑上克隆仓库。
2. 进入 server/ 目录，执行 ./deploy.sh <tv-ip>，把 <tv-ip> 换成电视的地址。
3. 在浏览器打开 http://<tv-ip>:8080/。

更完整的步骤和排错见安装文档。

主要功能

仪表盘按标签页组织：

• Home：替换 LG 首页，可选简洁内置启动器、自己的启动器，或 Home Assistant 仪表盘等网页；也可以把自有 IPTV 播放列表显示为一行频道。
• Control：遥控按键、音量、输入源、电源、睡眠定时、图像与声音设置、Game Optimizer。
• Privacy：一键关闭广告和遥测，包括 LG 的内容识别引擎；应用内会记录各项数据协议，大多可在仪表盘切换。
• Apps：从 Homebrew Channel 目录安装应用、卸载应用、关闭后台服务、隐藏 LG 内置应用。
• 按键重映射：把 Netflix、Prime Video、Guide、彩色键等快捷键指向任意应用、HDMI 输入或 Live TV。
• 屏保：十多种屏保可选，并支持亮度设置。
• 指标与 OLED Care：SoC 温度、CPU 负载、内存、Wi-Fi、存储、观看时长；OLED 面板累计使用时长、补偿周期、Pixel Refresher 倒计时与调度。
• 工程菜单：通过浏览器打开 LG 工程菜单，并可解锁新固件中被精简的版本。

Home Assistant 桥接会把电视作为一个 MQTT 设备暴露出来，支持 MQTT Discovery，也能转发遥控按键事件。

使用约束

• 需要电视已 root；支持 webOS 2.2 到 11，官方称已测试 2015–2026 年的 67 台电视、44 个系列（测试列表）。LCD 电视可用核心仪表盘，但没有 OLED Care。
• 仪表盘默认没有身份验证，只适合可信的本地网络；不要把 8080 端口转发到公网。令牌、限制网络访问和 MQTT 的安全设置见安全文档。
• 程序以 root 权限运行，重启、关机、息屏和 Pixel Refresher 调度会调用底层 luna-send。作者声明不承担设备损坏、变砖或保修失效的责任（README）。
• 采用 MIT 许可证；内置字体使用 SIL Open Font License 1.1。项目与 LG 无关，属非官方项目。

HotRepo 点评

在 2026 年 11 月的 JavaScript 月榜上，Glasshouse 当月新增 1,503 Star，最好名次为第 3，对一个小众的 root 电视工具来说相当突出。这与项目的定位相符：它把隐私开关、去臃肿、遥测和智能家居桥接整合进一个本地服务，价值具体而非概念性。主要门槛是 root 要求，受众限于已在用 Homebrew Channel 的 webOS 用户；对这部分用户来说，它替代了此前需要多个工具拼凑的流程。