Kaloyan DanchevandClaude Opus 4.6
cbea5a322f
Move trampoline files (boot-hook, watcher, overlay) into trampoline/ subdirectory. Add upstream Luma v2.3.1 source at repo root with our additions: - Page::Ha (4th nav tab) with placeholder empty state - HA tab config schema and default entity mapping (ha-home/) - Nav keys renamed: "home" → "start", new "ha" tab between Apps and Settings - All state.rs/view.rs/main.rs/tests.rs updated for 4-tab navigation Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# Luma Home
|
|
|
|
Fork of [Luma](https://github.com/ecklf/lg-luma) — a native launcher for rooted LG webOS TVs — with a Home Assistant integration tab and webOS 5/6 Home button support.
|
|
|
|
## What's different from upstream
|
|
|
|
- **Home Assistant tab** — a fourth nav tab ("Home") with glass cards for controlling HA entities (lights, climate, scenes, vacuum, etc.) directly from the TV remote
|
|
- **webOS 5/6 Home trampoline** — bind-mount overlay that redirects the Home button to Luma on older webOS versions (see `trampoline/`)
|
|
- **Settings app theme** — transparent overlay for the webOS Settings app (see `settings-theme/`)
|
|
|
|
## Structure
|
|
|
|
| Directory | What |
|
|
|-----------|------|
|
|
| `src/` | Rust source (SDL2 + OpenGL ES 2 renderer) |
|
|
| `assets/` | Generated artwork, fonts, wallpapers |
|
|
| `ha-home/` | HA tab config schema and default config |
|
|
| `trampoline/` | webOS 5/6 Home button redirect (boot hook, watcher, overlay) |
|
|
| `settings-theme/` | Transparent Settings app theme |
|
|
|
|
## Building
|
|
|
|
See `development.md` for the full build guide. Quick summary:
|
|
|
|
```sh
|
|
nix develop # enter the dev shell with cross-compilation toolchain
|
|
pnpm install # install JS tooling for asset generation
|
|
pnpm assets # generate native artwork
|
|
cargo build --release --features webos --target armv7-unknown-linux-gnueabi
|
|
```
|
|
|
|
## Target TV
|
|
|
|
- LG 65NANO813PA, webOS 6.5.3-47
|
|
- Rooted via Homebrew Channel v0.7.3
|
|
- Luma installed as `com.ecklf.luma`
|
|
|
|
## License
|
|
|
|
Upstream Luma is MIT licensed. See `license` file.
|