Remove obsolete launcher integration and reduce navigation jank

This commit is contained in:
Elijah Kuntz 2026-10-19 14:48:08 -07:00
parent ac0a892c5f
commit 2739b278cd
21 changed files with 394 additions and 129 deletions

View file

@ -1,12 +1,12 @@
# Luma for Android TV
A native, remote-first Android TV launcher designed for limited-memory streamers and integrated TVs. It is installed alongside Projectivy as `tv.luma.launcher`; Projectivy remains available as a fallback.
A native, remote-first Android TV launcher designed for limited-memory streamers and integrated TVs. Its package name is `tv.luma.launcher`.
Version **1.1.11** reuses unchanged app tiles when returning Home and avoids reloading already displayed Plex artwork. Every resume restores missing images, including when Android briefly pauses the launcher without stopping it. Leaving the launcher releases image memory. Updates can be installed directly from the TV; physical-input controls appear on compatible TVs.
Version **1.1.12** removes obsolete alternate-launcher integration, avoids redundant screen-on window updates during navigation, and waits for focus to settle before transitioning app background colors. Every resume restores missing images, including when Android briefly pauses the launcher without stopping it. Leaving the launcher releases image memory. Updates can be installed directly from the TV; physical-input controls appear on compatible TVs.
## Use it
Press **Home**, or open **Luma** from Projectivy's app list. Set `LUMA_ADB_DEVICE` to your connected ADB device address to open it from a computer:
Press **Home** after configuring Home routing, or open **Luma** from Android's app list. Set `LUMA_ADB_DEVICE` to your connected ADB device address to open it from a computer:
```sh
.tools/platform-tools/adb -s "$LUMA_ADB_DEVICE" shell am start -n tv.luma.launcher/.MainActivity
@ -20,13 +20,11 @@ Press **Home**, or open **Luma** from Projectivy's app list. Set `LUMA_ADB_DEVIC
## Default launcher and Home routing
**Settings → Default launcher** provides Android's Home app chooser, a Home button override toggle, and a direct Projectivy fallback. Enabling the override opens Android Accessibility settings; enable **Luma Home button** there. Turning it off in Luma disables only Luma's accessibility service.
**Settings → Default launcher** provides Android's Home app chooser and a Home button override toggle. Use the native chooser where supported. On devices that keep routing Home to Google TV, enable **Luma Home button** in Android Accessibility settings. Turning the override off in Luma disables only Luma's own service.
On this onn. device, Android records Luma as the Home role holder but still resolves Home to Google's launcher. Luma's accessibility workaround redirects that stock Home window and handles Home key events where Android delivers them. It runs in a separate small `:home` process so the launcher UI and its artwork can still be reclaimed while another app runs. It requests window-state events only from Google Home and Projectivy, without permission to retrieve window content. It has no polling loop or network work.
The event-driven helper handles Home keys where Android delivers them and redirects Google's stock Home window. It runs in a separate small `:home` process so artwork memory can be reclaimed when another app opens. It cannot retrieve window content and has no polling loop or network work. Android's stock launcher remains installed.
Projectivy's **Settings → General → Override current launcher** is switched off to avoid competing Home handlers. Projectivy's application and accessibility service, and Button Mapper's accessibility service, remain enabled. The Projectivy app tile and **Open Projectivy** deliberately allow the fallback to remain open until the next Home press. Back stays on Luma.
To return to the previous routing, turn off Luma's Home override, then open Projectivy and re-enable **Override current launcher**. No launcher needs to be disabled or uninstalled. The native chooser uses Android's [Home role API](https://developer.android.com/reference/android/app/role/RoleManager); the workaround uses the documented [AccessibilityService callbacks](https://developer.android.com/reference/android/accessibilityservice/AccessibilityService).
The native chooser uses Android's [Home role API](https://developer.android.com/reference/android/app/role/RoleManager); the override uses documented [AccessibilityService callbacks](https://developer.android.com/reference/android/accessibilityservice/AccessibilityService).
## TV inputs
@ -46,7 +44,7 @@ Luma opens an available standard TV channel viewer, with Android's native `TvVie
**App labels** offers Always, Focused only (default), and Never. Accessibility app names remain available in all modes. Other settings include 5/6/7 columns, background dimming, automatic or fixed accent colors, reduced motion, clock visibility, and 90-second scene rotation. Alpine uses the bundled original wallpaper; Aurora and Midnight are inexpensive procedural gradients.
Focus uses a 6.5% scale increase, a 160 ms transition, and an app-colored cached soft shadow. Background crossfades last 280 ms. App accent changes wait for a 160 ms pause in color selection, coalescing passing selections during rapid navigation while tile focus feedback stays immediate. Reduced motion applies colors immediately. **Memory saver** in Appearance is off by default on every device. Enabling it reuses the background while app accent colors change, reducing image allocation and uploads; animation speed can vary with the graphics driver. It can be switched off at any time. The launcher has no continuously rendered blur or background video. Optional screensaver video runs only while the screensaver is visible.
Focus uses a 6.5% scale increase, a 160 ms transition, and an app-colored cached soft shadow. Background crossfades last 280 ms. App accent changes wait for a 250 ms pause in color selection, coalescing passing selections during rapid navigation while tile focus feedback stays immediate. Reduced motion applies colors immediately. **Memory saver** in Appearance is off by default on every device. Enabling it reuses the background while app accent colors change, reducing image allocation and uploads; animation speed can vary with the graphics driver. It can be switched off at any time. The launcher has no continuously rendered blur or background video. Optional screensaver video runs only while the screensaver is visible.
The app grid uses one 260 ms scroll animation for remote focus movement. **App section text** can hide the heading, installed count, and customization hint; it is hidden by default without changing the original spacing.
@ -130,7 +128,7 @@ For a fresh macOS checkout, run `scripts/bootstrap.sh`, review/accept the SDK li
The local build creates and reuses `.tools/luma-development.keystore`. Preserve that file to install future updates over the existing APK. It is ignored by source control. This is a development signing identity for your sideloaded build; configure your own signing identity before distributing it.
To remove only Luma, run `adb uninstall tv.luma.launcher`; Projectivy remains installed. No command in the build/install scripts disables another launcher or changes the default Home app.
To remove Luma, run `adb uninstall tv.luma.launcher`. No command in the build/install scripts disables another launcher or changes the default Home app.
## Device checks