ecklf/lg-luma

If you have rooted your LG set and find its stock home screen slow or cluttered, Luma is worth a look — but plan for per-TV compatibility checks and a manual takeover setup.

The problem

On a rooted LG TV the daily loop is: power on, wait for the stock webOS home to load, scroll past promotional rows, then find the app you want. Users who already run Homebrew Channel want a cleaner entry point that puts favorites and inputs first. Luma replaces that landing screen with a native launcher, so after boot you arrive at a customized home surface instead of LG's default, and app launches still go through the TV's own app manager.

What's different

Luma is written in Rust and renders natively rather than wrapping a web page, which is the basis for the responsive feel shown in the demo video. It reads the installed app inventory on the TV, supports favorites and hidden apps, shows input settings and basic weather, and stores its state in local JSON under an app-owned persistent directory. Weather lookups go to Open-Meteo and the README states there is no browser geolocation, IP-based lookup, telemetry or runtime font download.

The trade-off is that replacing LG Home is not a single switch. There are three documented paths: a takeover method on webOS 5, 6, 25 and 26; an autostart script for when takeover is disabled; and an LG Input Hook mapping. Takeover does not delete LG Home — it sits under a temporary mount that a reboot clears — but if you uninstall Luma first, a separate boot hook remains and logs errors, so clean removal means disabling takeover before uninstalling. The autostart path launches Luma as a regular app and does not remap the Home button.

Who should try it

This fits someone with a rooted LG TV who wants a console-like home surface, is comfortable with SSH and a shell, and is willing to keep track of whether Home takeover works on their exact model. The README's compatibility tables list confirmed models and mark takeover support as yes, no or unknown, so a model marked with no or a dash is not a good candidate for the takeover route.

It is a poor fit for anyone who wants a zero-maintenance tweak: every method involves either a boot hook or a remapped button, and switching between methods requires disabling the previous one. It is also not for unrooted TVs, since installation depends on Homebrew Channel or root SSH.

Requirements and limitations

The hard requirements are a rooted TV running webOS 4 or newer and one of the documented install routes: Homebrew Channel or root SSH with the install command. webOS 4 is listed as starting territory, but takeover is only supported on 5, 6, 25 and 26, so older sets may need autostart or the Input Hook method.

Ongoing upkeep matters more than the first install. The README warns that native caller permissions and lifecycle behavior can differ by firmware, and that Home-button mappings in LG Input Hook must be cleared or tested on a spare button first. Before committing, check the compatibility table for your model identifier and decide which replacement method you can live with, because moving between methods means undoing the old one.

HotRepo's take

HotRepo recorded 192 total stars and #21 on the NEW-REPOSITORY board (new projects, Rust) on 2026-10-27; this is a one-day snapshot, not a growth series, so persistence cannot be judged. The project was created 2026-10-19, making it barely a week old. The practical thing to verify before installing is whether your exact LG model appears in the Home takeover table and which method the README recommends for it.