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.
▶ Watch the full promo video (1 min)
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
Movies, series and music
Games (Moonlight)
Smart Home
Widgets
Settings
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.
