Skip to content

LG webOS TV launcher: a fast, remote-first home screen with live video wallpapers, widgets, Jellyfin, Moonlight game streaming and Home Assistant. Native Rust + OpenGL ES.

README

Luma: LG webOS TV Launcher

A fast, remote-first launcher and home screen for LG webOS TVs, with an Apple TV feel.

Luma replaces the cluttered LG Home with one calm screen: your favorite apps, live video wallpapers, widgets, your Jellyfin library, your PC games over Moonlight and your Home Assistant devices. It's a native Rust app drawn with OpenGL ES, so it stays smooth on TV hardware.

Free and open source (MIT). Fork it, change it, ship it.

Luma promo video

▶ Watch the full promo video (1 min)

Home

Features

Home

  • Favorite apps row and "stacks": rows of content from Jellyfin, Moonlight and more, each capped at 20 cards with a View Library page behind it.
  • Live video wallpapers: Apple and Amazon aerials, played in hardware. Pick whole collections or single clips.
  • Frosted-glass UI with one accent gradient, adjustable colors, heading and text fonts, and UI resolution (Auto / 4K / 1440p / 1080p).
  • A headline that comments on the weather, plus a clock and date.

Widgets

  • Weather (Open-Meteo, no API key), with hourly and 10-day forecasts.
  • Crypto prices with charts (Binance, Coinbase, Kraken and others; public endpoints only).
  • HDMI input preview and Home Assistant status line.
  • Small, medium, large and text-line sizes, laid out on a grid.

Movies, series and music (Jellyfin, Plex)

  • Sign in with a code or a QR code on your phone: no typing with the remote.
  • Movie and series pages with backdrop, cast, seasons, episodes and "More like this".
  • A built-in HTML5 player (com.denisefremov.luma.player) with audio and subtitle track selection, quality and seek previews. Playback progress syncs back to your server.
  • Music: albums, songs and a now-playing screen.
  • Plex support is new and less tested than Jellyfin.

Games (Moonlight)

  • Your Steam library from a PC running Sunshine or Apollo, shown as a stack with Steam artwork.
  • Game pages work like movie pages. Play opens the stream in Moonlight.

Smart Home (Home Assistant)

  • Pair by scanning a QR code with your phone. Your token never has to be typed on the TV.
  • Status chips (climate, alarm, lights, doors), scenes, live cameras and device tiles you can toggle with the remote.
  • Hide any camera or device from the TV.

Remote and pointer

  • Built for the D-pad: Back always steps one level out.
  • The Magic Remote pointer works everywhere, including drag-to-scroll.

Screenshots

Home and apps

Home with widgets Home, morning mist wallpaper
Jellyfin rows on Home All apps

Movies, series and music

Movie page Series page with episodes
Now playing Album

Games (Moonlight)

007 First Light Cyberpunk 2077

Smart Home

Smart Home tab with cameras Home Assistant settings

Widgets

Weather Crypto

Settings

General: language, clock, motion Wallpaper sources
Pick wallpaper clips Appearance
Accent colors Stacks
HDMI inputs System and root features

Support Luma

Luma is built and maintained by one person in their free time. It's free and will stay free. Donations decide how much time goes into it: they keep updates coming, pay for test hardware and move the roadmap forward (Plex, more TV models, new widgets). If Luma makes your TV better, a coffee helps keep it alive.

Made by Denis Efremov, an interface designer with 16+ years of experience and the maker of Luma and Rift, two free open-source launchers. Read the design story in the Luma case study.

Root features

Luma runs as a normal app without root. On a rooted TV (Homebrew Channel, elevated), Settings › System › Root features appears with extras:

Feature Without root With root
Open Luma when the TV turns on — ✓
Turn LG Home "Auto Launch" off from Luma — ✓
Leave a Moonlight stream with Start + Select pressed twice — ✓
Full app and HDMI input list, app icons basic ✓ more reliable
Detect whether an HDMI input has a signal — ✓

Without root the Root features section is hidden, and Luma never tries to change system files.

Install

Homebrew Channel

Add this repository in Homebrew Channel › Settings › Repositories:

https://github.com/funnymataleao/luma-webos-launcher/releases/latest/download/repo.json

Then install Luma and Luma Player from the list. The companion player is required for Jellyfin and Plex video playback.

Manual (IPK)

Download com.denisefremov.luma_2.2.160_arm.ipk from Releases and install it with webOS Dev Manager or ares-install. To play Jellyfin and Plex videos, also install com.denisefremov.luma.player_0.0.11_all.ipk from the same release.

To use Moonlight, install Moonlight for webOS and pair it with your PC first, then open Luma.

Build from source

Requirements: Rust 1.88+, Node 22+, pnpm 10, SDL2 (for the desktop preview).

pnpm install --frozen-lockfile
pnpm sdk                     # downloads the webOS NDK and runtime into .build/
export WEBOS_NDK="$PWD/.build/toolchain/arm-webos-linux-gnueabi_sdk-buildroot"
pnpm run package             # → dist/*.ipk, sha256sums, repo.json

Desktop preview with sample data (no TV needed):

pnpm assets
pnpm dev

Tests: pnpm test. Lint and format: pnpm check, pnpm format. More in development.md.

Tech stack

Part Built with
Launcher Rust 2024, SDL2, OpenGL ES 2 with custom GLSL shaders
Text and vector art owned_ttf_parser, our own SVG → triangle compiler (lyon tessellation), signed-distance edges
Images image (PNG, JPEG, WebP), decoded off the render thread
Networking ureq + rustls, tungstenite WebSocket (Home Assistant), mdns-sd and UDP discovery
Moonlight pairing rcgen, rsa, x509-parser, AES (GameStream / Sunshine protocol)
QR codes qrcode
Video wallpapers webOS hardware media pipeline (C helpers in native/), HEVC and H.264
Player Separate web app: HTML5 video, HLS, vanilla JS
TV integration Luna service bus, Homebrew Channel elevated service
Build tooling pnpm, Node, sharp, @webos-tools/cli, Nix flake, oxlint / oxfmt, Changesets
Data sources Open-Meteo, Jellyfin, Plex, Home Assistant, Steam store artwork, public crypto exchange APIs

Privacy

  • No telemetry, no accounts, no ads.
  • Settings, favorites and tokens stay in a local JSON file on the TV.
  • No API keys are built in. Sign-ins go through Quick Connect, Plex link codes or a QR code on your phone.
  • Weather uses the location you choose, never IP geolocation.

Fonts and assets

All bundled fonts are under the SIL Open Font License; each font ships with its OFL.txt. See assets.md for wallpapers, icons and their licenses. Brand logos belong to their owners. Luma is not affiliated with LG, Apple, Amazon, Valve, Jellyfin, Plex or Home Assistant.

Credits

Luma started as a fork of ecklf/lg-luma by ecklf and contributors. Thank you for the native renderer, the build pipeline and the original idea.

Also thanks to webOS Homebrew, Moonlight, Sunshine / Apollo, Jellyfin and Home Assistant.

How this was made

Most of the code in this fork was written with AI coding assistants (Claude Code and OpenAI Codex), directed and tested on a real LG OLED C1 by the maintainer. Every change was checked on the TV before release.

License

MIT. Original copyright © 2026 Luma contributors.