Ad-free home screen: our launcher displays no ads or the promotions you would normally see on LG Home. It does not change LG's underlying privacy or data-collection settings. Read LG privacy concerns, what this launcher does, and securing your media/IoT network.

Public release v0.4.0. See compatibility and validation.

A configurable home screen for LG TVs: streaming apps, HDMI sources, weather, room temperatures, lights, energy flow and configurable appliance/device status. Designed for the remote, with a compact 1920×1080 layout that scales to the screen.

The launcher talks directly to your Home Assistant. The setup computer can be shut down afterwards. No cloud account with this project, Mac service, Docker relay, or custom HA integration is required.

Start here · Screenshots · Configuration · Manual Home-button helper · Troubleshooting · All documentation

Make it yours: backgrounds, card styling, custom arrangement and animated energy flow. Actual app previews with sample data.

Four new layout themes: Dock, Weather, Sidebar and Panorama. Actual app previews with sample data.

1. Download the release source, verify its checksum and start the local configurator.
2. Choose a layout, connect HA and build your own private IPK. The public sample IPK has no HA token.
3. Enable TV Developer Mode, then pair and install with webOS Dev Manager.
4. Check the base app on your TV before adding startup automation or the optional manual Home-button helper.
5. Keep Developer Mode active: set up the supplied HA renewal package, reuse existing Camera Overlay renewal, or extend the session manually before expiry.

The computer is only needed for setup and updates. The installed TV app connects directly to your existing HA instance. The helper is an advanced, model-dependent option; the base app can be used without it.

• Four new layout themes — Dock, Weather, Sidebar and Panorama — plus Classic, with six independent colour palettes and custom colours.
• Personal backgrounds and an optional theme customizer: up to five optimized images, rotation, opacity/darkening, four card finishes including Glass, corners and per-card colours.
• Drag-and-drop app/control ordering and a Custom arrangement for the four screen rows.
• Animated house energy flow alongside the classic diagram and simple readings; optional battery and charger branches.
• Embedded Cloudflare Speed Test and optional router/internet TCP latency, measured on the TV with no separate server.
• Condition-based weather artwork with optional HA Sun day/night selection.
• A local browser wizard for Windows, macOS and Linux, with a working sample preview.
• Read-only HA entity discovery and selection; no YAML editing for the launcher.
• Up to 8 app/input tiles, 6 controls, 12 temperatures (first 3 on the main card), 4 generic appliance/status rows and an optional energy card.
• Common app presets, optional logos, Live TV and TV Guide tiles. Mix text and logos; keep your existing exported layout.
• Export/import of credential-free layout profiles. One profile per TV.
• A private configured IPK built on your own computer. No source edits required.
• An optional HA startup automation blueprint.
• Optional Home-button helper source, build scripts and extensive manual adaptation/recovery instructions. It is never automatically installed or enabled by the wizard.

The MBS configurator has its own branding. The TV app has no MBS logo or branded colour scheme.

See backgrounds, card styles and animated energy flow, or explore all layout and colour combinations: 24 combinations for the four new themes, six for Classic, and one custom-colour example per layout. App tiles stay the same throughout the gallery.

Dock · Forest	Weather · Dusk

Sidebar · Sand	Panorama · Slate

For setup screens, see the six-step configurator walkthrough. Themes and colours explains how to choose and apply a design.

Install Node.js 22 or newer. Extract this project outside shared/cloud-synced folders, then run from its folder:

npm ci --ignore-scripts
npm start

On Windows PowerShell use npm.cmd in place of npm. Open http://127.0.0.1:8780/. No TV or HA connection is needed to explore the design. Preview buttons never send device commands. Stop the wizard with Ctrl+C.

This is a sideloaded webOS app, not an LG Content Store release. Developer Mode is required. The base app does not replace LG's Home button; use the separately documented helper if your model supports it. The helper is a native program plus JavaScript controller/service, not a universal shell script.

Configuration changes are made in the wizard and applied by rebuilding/reinstalling the package. There is no on-TV settings editor or QR pairing flow. Import your saved profile to update it. This deliberately avoids relying on localStorage surviving packaged-app updates.

Your private configured IPK contains your HA access token. Do not share it. Public sample packages contain no credential and show “Setup required” on a TV. The browser preview uses fictional sample readings even after HA discovery.

The community app IDs are com.mbs.communityhome and com.mbs.communityhomehelper.

The current launcher is expected to work on webOS 4.x and newer (2018 TVs onward). The base launcher, live Home Assistant data and Home-button helper are also community-confirmed on OLED55B7V-Z with reported webOS/SDK 3.9.0. Other webOS 3.x models remain unverified and may need compatibility changes. Compatibility is model- and firmware-specific.

LG introduced the webOS 4.x generation in 2018. The compatibility estimate is based on its Chromium 53 app engine, which our TV code targets. webOS 1.x–2.x use older WebKit engines and are not currently supported or tested. See LG's web-engine table and compatibility and validation for model sources and feature-specific results. The helper remains model/firmware-dependent; the latest background rotation and Glass options have not yet had physical TV performance acceptance.

Own code is GPL-3.0-only. The adapted helper retains its MIT notices. See NOTICE and licensing. Independent project; not affiliated with LG or Home Assistant.