first commit

This commit is contained in:
Elijah Kuntz 2026-10-17 22:38:45 -07:00
commit f5f1c0928f
39 changed files with 4478 additions and 0 deletions

21
docs/ASSETS.md Normal file
View file

@ -0,0 +1,21 @@
# Original artwork
The bundled wallpaper is `app/src/main/assets/alpine.jpg`. It was generated with the built-in imagegen tool, then resized/encoded as a 1920 × 1080 JPEG for the TV. No remote wallpaper service is contacted by the launcher.
Final generation prompt:
> Use case: photorealistic-natural. Asset type: original cinematic wallpaper for a premium Android TV launcher. Create a 16:9 landscape image, 2560x1440 if possible, of a tranquil otherworldly alpine lake at blue hour, a monumental jagged mountain ridge on the right two thirds, subtle warm rose gold sunlight touching snowy peaks, tiny atmospheric mist and crisp reflections in deep indigo water. Rich midnight navy, muted teal and soft warm peach highlights, filmic realism and exquisite landscape photography, restrained contrast. Composition: left third is very dark open sky and calm shadow water for white UI title overlay. Bottom third is dark uncluttered water fading into navy for app icons. Main lit mountain subject is upper right. No people, no buildings, no text, no UI, no logos, no watermark. This is background artwork only, not a mockup.
App banners and icons are loaded from installed Android packages and retain their respective owners' branding. Plex artwork is retrieved from the user's connected server. Aurora and Midnight scenes are code-native gradients.
# Screensaver media
The offline image catalog is `app/src/main/assets/saver/catalog.json`, with titles, credits, and source links. The Met's object API marked each included painting `isPublicDomain=true` at retrieval; only works with that flag and an available image are eligible for in-app gallery downloads. See [The Met Open Access API and CC0 description](https://metmuseum.github.io/).
- [Van Gogh, Wheat Field with Cypresses](https://www.metmuseum.org/art/collection/search/436535)
- [Hokusai, The Great Wave](https://www.metmuseum.org/art/collection/search/45434)
- [Jacques Louis David, The Death of Socrates](https://www.metmuseum.org/art/collection/search/436105)
- [NASA, Earth / Blue Marble](https://images.nasa.gov/details/PIA18033), NASA/NOAA
- [Webb, Cosmic Cliffs in Carina Nebula](https://images.nasa.gov/details/carina_nebula), NASA/ESA/CSA/STScI
Optional bird video: [Mountain Moment: Steller’s Jay, Mount Rainier National Park](https://www.nps.gov/media/video/view.htm?id=5F3DC793-5998-42A6-B7AE-5165B7C12EA2). The source credits NPS and identifies NPS-credited media without a copyright symbol as public domain. The 720p MP4 is downloaded directly from NPS only when requested, and is not bundled into the APK.

41
docs/VALIDATION.md Normal file
View file

@ -0,0 +1,41 @@
# Device validation
Validated on the user’s onn. 4K Plus Streaming device over ADB, October 17, 2026 (America/Phoenix). Android 14 / API 34, approximately 1.88 GiB physical RAM, 1920 × 1080 render override on a 4K display.
## Functional checks
- Native app discovery, D-pad focus across rows, OK launch, long-press management menu, and settings navigation.
- Artwork only, Dynamic, and Minimal banner modes; original spacious layout restored as the default. Focused-only labels and hidden app-section text are the defaults.
- Smooth focus scrolling across all app rows, including the All apps footer, and back to the first row.
- Plex connection, bounded rows, artwork, encrypted token storage, and disconnect verified against a temporary local fixture. Fixture credentials were removed. A real Plex account/server has not been connected; actual Plex authorization and title playback remain unverified.
- Art screensaver: all three bundled paintings decoded and displayed, sampled for nonblank pixels, with pure-black side mattes. Captions have a dark gradient and text shadows. Paintings retain their full aspect ratio in Auto/Fit.
- Scenic photo preview, single-button wake, and real one-minute idle activation passed. Idle timeout was restored to ten minutes, photo duration to thirty seconds, and mode to Scenic.
- NPS bird video downloaded to private device storage (about 40 MB), played locally in a loop, and stopped on leaving Luma. The local file remains available in Nature video mode; no ongoing stream/download is active.
- Home routing: Android reports Luma as HOME role holder but the OEM resolver still chooses Google Home. The enabled Luma accessibility service routes Home to Luma. Repeated Home presses, return from Android settings and SmartTube, and screensaver dismissal were checked.
- Projectivy fallback stays open when explicitly selected through its app tile or Settings. Back stays on Luma; from lower rows it returns to the first row. Home returns to Luma. Projectivy remains installed and enabled; only its competing “Override current launcher” preference is off. Its accessibility service and Button Mapper’s service are retained.
- Luma’s override Off control removes only its own accessibility service. Re-enabling through Android’s actual Accessibility settings was verified. The service is system-bound in a separate `tv.luma.launcher:home` process. No view-content retrieval capability is requested.
## Performance
Final device sample with the Home override enabled:
| Measurement | Result |
| --- | --- |
| Launcher UI foreground PSS | 95,566 KiB (93.3 MiB) |
| Launcher UI cached/background PSS | 66,635 KiB (65.1 MiB), reclaimable |
| Separate Home router PSS | 6,348 KiB (6.2 MiB) |
| Launcher background CPU | 0 CPU ticks over 10 seconds |
| Home router idle CPU | 0 CPU ticks over 10 seconds |
| Focus navigation rendering | 84 frames, 4 janky (4.76%); 95th percentile 24 ms |
The separate Home router avoids retaining the UI image heap. Android can reclaim the UI while the router stays bound; Home then creates the UI again. This is not a guarantee of perfect 60 fps.
Raw measurements are recorded in `../output/luma-*-memory.txt`, `../output/luma-background-cpu.txt`, and `../output/luma-focus-frames.txt`. PSS includes framework/graphics allocations and fluctuates with system state. Short CPU samples indicate idle behavior, not a guarantee covering all usage.
## Scope
No launcher application was disabled or uninstalled. Screensaver selection at the Android system level was not changed. Standard Android Dream settings are unavailable on this TV, so the customizable idle screensaver runs while Luma is foreground. No real Plex credentials were extracted or used. The UI-reclaim test explicitly killed the cached UI process while leaving the Home router bound, then verified that Home restored Luma. No reboot test was performed.
Build validation uses aapt2, javac, D8, zipalign, and apksigner signature verification. There are no third-party runtime libraries.
Final APK: 2,737,238 bytes. SHA-256: `46ca53681ff7fc34651402a8e4e806aa0fde7f7e49516aa94d8342ee762472a3`.