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.

• ☕ Ko-fi: ko-fi.com/dennis_oizo
• 🍵 Buy Me a Coffee: buymeacoffee.com/denisefremov
• 💖 GitHub Sponsors: github.com/sponsors/funnymataleao
• 🪙 USDT (TRC20): TKPVRy9oYjLsbQMtbDzvkXDu73mg7tLN5u

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.