rorygallagher2024/glasshouse

Own the glass. A dashboard, privacy controls and Home Assistant bridge for rooted LG webOS TVs.

Glasshouse is a server that runs directly on a rooted LG webOS TV, providing both a live browser dashboard and a dashboard app.

Use it for remote control, app installation and removal, OLED panel care, privacy controls, service menu access, and hardware telemetry. It also includes an MQTT bridge for integrating the TV with Home Assistant and other smart-home software.

• webOS: 2.2 through 11 (LG's webOS 26) confirmed; tested across 2015–2026 models. Other versions likely work as well. LG names its versions two ways: webOS version numbers gives both
• Panels: OLED (full panel wear telemetry and burn-in controls) and LCD (core dashboard, controls, and telemetry; OLED Care tab hides automatically)
• Access: Rooted via Homebrew Channel. Telnet or SSH. No external dependencies or internet access needed on the TV
• Tested hardware: 44 TVs across 29 series verified so far (LF632V, UH6030, UH610V, UH635V, B7, B8, C8, LM57, UM73, C9, CX, GX, C1, UP80, UP81, QNED82, C2, G2, C3, B4, G3, C4, G4, UT81, C5, G5, CS, LX3, NU80). Other rooted models should work; see full table

Read the documentation for the features, installation, Home Assistant and security.

1. Root the TV and install the Homebrew Channel.
2. Clone this repository on a computer on the same network as the TV.
3. Run ./deploy.sh <tv-ip> from the server/ directory.
4. Open http://<tv-ip>:8080/ in a browser.

That's it. The dashboard is ready to use.

The installation guide has the details and troubleshooting.

This project is intended to give a rooted webOS TV a useful local control surface instead of requiring the owner to work around the TV's built-in menus, vendor services and cloud dependencies.

1. Controlling the TV without the cloud. A D-pad to navigate the TV itself, volume, mute, media playback keys (play, pause, stop, skip), app launcher, picture presets, sound output routing, power and reboot.

2. Seeing what the TV is configured to collect, and switching it off. Whether LG's content-recognition engine is running and sampling the screen, the advertising identifier and whether ad tracking is limited, and every data agreement recorded on the TV with most of them switchable from the dashboard. Includes an on-TV blocker for LG's ad and telemetry endpoints, and a switch for the two diagnostics services that upload to LG.

3. App management, debloating and home screen cleanup. Install apps from the Homebrew Channel catalog, permanently uninstall apps to reclaim internal flash storage, disable unnecessary background system services to free up RAM and CPU cycles, stop LG keeping apps loaded in the background that are never used, hide non-removable built-in LG system apps from the home launcher, and on webOS 9 strip LG's Home screen down to the apps and inputs.

4. Replacing the screen saver. A clock, a starfield, fireworks, or the TV's own readings, each dim or bright, in place of LG's.

5. Integrating the TV with a smart home. The MQTT bridge exposes the TV as a single device with its controls and telemetry, with Home Assistant support through MQTT Discovery and the same underlying interface available to other MQTT clients. You can also send button press events to Home Assistant to control your smart home from your TV remote.

6. Seeing what the TV is actually doing. SoC temperature, per-core CPU load, memory, swap, Wi-Fi signal and throughput.

7. Observing OLED panel wear. Cumulative panel hours, compensation cycle progress, Pixel Refresher countdown with scheduling, completed cycle counters and refresher failure alerts.

8. Controlling the OLED burn-in protections. What each one does and a switch for it: screen shift and logo dimming on any OLED, and on TVs that expose them, ASBL and Global Stress Reduction (normally reachable only from the TV's service menu, with a service remote and a PIN).

9. Opening the service menu, and unlocking it where it is locked. LG's own engineering menu, put on the TV screen from a browser which means no service remote is needed. Newer firmware shows a cut-down version of it until it is unlocked, which the dashboard can do as well.

10. Reading all of it on the TV itself. An optional app on the home screen puts the same readings and controls on the TV, driven by the remote, for when there is no phone or laptop to hand.

11. Managing TVs from Android. A phone app that keeps a list of TVs, shows which are online, wakes them over Wake-on-LAN, and opens each one's dashboard full screen.

 
_{Metrics and Control tabs, shown in dark and light themes.}

More screenshots, including Home Assistant.

Glasshouse for Android keeps a list of TVs, shows which are online and opens each one's dashboard full screen. A TV is added by scanning any QR code on its dashboard, which carries the token as well. See the Android app documentation for more details.

The app is in closed testing ahead of its Play Store release. To test it:

1. Join the glasshouse-android-testers Google Group with the Google account the phone uses for the Play Store.
2. Opt in on the testing page, signed in with the same account.
3. Install Glasshouse from the Play Store link on that page.

Play only releases the app publicly once testers have stayed opted in for 14 days, so leaving the group early holds it back. Problems and suggestions go in the app's issues.

• Installing and tested TVs
• The dashboard, tab by tab
• Home Assistant, entities and remote button events
• Updating and uninstalling
• Security
• What it changes on the TV
• Internals

The pages are built from docs/, so they can also be read there.

The dashboard has no authentication by default, for frictionless control from any phone or browser on a trusted local network. Never expose port 8080 directly to the internet (do not port-forward). Security covers the token, closing the port to the network, and MQTT.

Use this software at your own risk.

• Root access and hardware. This runs custom software with root privileges on an embedded TV OS. It is designed to be lightweight and to leave the read-only rootfs untouched, but the author accepts no responsibility for damage, bootloops, bricked devices, voided warranties, data loss or panel issues.
• Power and control commands. Reboot, power off, screen blanking and Pixel Refresher scheduling issue low-level luna-send calls. Understand what each does before using it.
• Trademarks. An independent, unofficial community project, not affiliated with or endorsed by LG Electronics. webOS is a trademark of LG Electronics.
• Fonts. Bundles Outfit and Manrope under the SIL Open Font License 1.1; licence texts ship in server/assets/fonts/.

MIT. See LICENSE.