Hi all,
I'd like to introduce Lume, a home screen for Android TV that I built around one idea: be simple and use as little of the TV as possible, so the memory and CPU go to what matters, your streaming apps. And I'd really like your feedback to make it better.
Why I built it
I have a TCL 55C715 with 2 GB of RAM. Over time it got slow: going home took a while, switching apps stuttered, and the remote sometimes felt unresponsive.
I looked inside with adb (read-only) and found:
RAM basically gone (about 100 MB available) and swap 100% full. The system was burning CPU and storage I/O just paging memory.
The biggest process on the TV was the stock launcher itself: 175 MB of memory and around 34% CPU, just to show the home screen.
The screen you look at for five seconds before opening Netflix was competing with Netflix for memory. That's how Lume started.
Simple on purpose
Lume does a few things, and does them well:
A home screen with a dock of your favorite apps (the focused icon grows, neighbors make room).
An "Apps" screen with everything installed.
Short settings: pick favorites, round or square icons, wallpaper.
Everything with the normal remote: arrows, OK, Back and Home.
No ads, no recommendations, no telemetry, no internet access.
English, Portuguese (Brazil), Spanish, Indonesian and Russian, following the TV's language.
Open source (GPL-3.0).
Optimized to use as little as possible
Every design decision aims at lower resource usage:
Written in Rust, with no WebView, no Android View framework and no heavy libraries. It draws its whole UI itself with OpenGL ES 2.0, which runs even on cheap TV GPUs.
It truly idles when nothing changes on screen: with no animation running, it draws no frames and CPU drops to zero.
When you open another app, it releases all of its GPU memory and keeps only what it needs to come back quickly.
Large images (wallpaper, the photo sent from your phone) live in their own memory, handed back to the system as soon as they're no longer needed.
The numbers, measured with dumpsys meminfo and dumpsys SurfaceFlinger on the TCL 55C715 (Android 11, 2 GB RAM, Mali-470 GPU):
| Lume | Stock launcher |
|---|
| Idle memory on the home screen (PSS) | ~14 MB (first release) to ~24 MB (with wallpaper) |
| CPU while idle on home | 0.00% |
| Threads | 15 |
| GPU memory while another app is in front | 0 |
| Dropped frames in a 60 fps motion test | 0 of 868 |
In practice: home comes back faster, navigation is smooth, and streaming apps get more free RAM.
Your own wallpaper, sent from your phone
This is my favorite part. Besides the six wallpapers made for the project, you can use your own photo with no USB stick and no phone app:
In Lume's settings, pick "My image". The TV shows a QR code.
Point your phone's camera at it. A page opens in your phone's browser.
Pick a photo (iPhone HEIC works too), frame it and zoom right there, and tap send.
The TV shows the preview instantly. Press OK to apply.
It all stays on your local network: the photo goes straight from the phone to the TV, through no server. The TV only listens while that screen is open and closes the connection when you leave.
Tested on
TCL 55C715 (Android 11, 2 GB, 1080p): the reference device, where everything was measured.
AIWA Smart TV (made by KTC, Android 14, ~900 MB RAM, 720p, low_ram): the hardest case. Runs at 60 fps with no dropped frames (0 of 1013 in the test). Total memory there is higher (~60 MB), but almost all of it is the graphics driver and Android 14 itself; Lume's own share is ~13 MB, the same as on the TCL.
Android TV 9 emulator, to cover the minimum supported version.
I need your feedback
Two TVs isn't much, and every manufacturer changes Android in its own way. Lume will only get really good with the community's help. I'm looking for people willing to install it and tell me how it went:
Other brands of TVs and boxes: Sony, Philips, Xiaomi (Mi Box / Mi TV Stick), Chromecast, Nvidia Shield, generic boxes.
Whether the remote's Home button opens Lume, or whether your TV insists on its own launcher (some do).
Performance: did it feel faster or not? If you use adb, the output of adb shell dumpsys meminfo helps a lot.
The phone wallpaper upload: did it work with your phone and your network?
What's missing for it to become your everyday launcher, without losing its simplicity.
Translations: if your language isn't listed, translations are plain strings.xml files.
Bugs and ideas: open an issue on GitHub or just comment here. All feedback, good or bad, is welcome.
How to install
Lume isn't on the Play Store yet, so you send it to the TV from a computer on the same network. First, turn on debugging on the TV:
Settings โ Device Preferences โ About, select Build and press OK 7 times until you're a developer.
In Device Preferences โ Developer options, turn on USB debugging (and network debugging, if you see it).
Write down the TV's IP address from Settings โ Network & Internet.
Then pick one of two ways:
Way 1: with adb (the traditional way)
Download Google's SDK Platform-Tools and the Lume APK from the releases page. In the platform-tools folder, run (with your TV's IP):
adb connect 192.168.1.50:5555
adb devices
adb install lume-0.8.1.apk
adb shell cmd package set-home-activity app.lume.tv/.LumeActivity
On the first adb connect, accept the "Allow USB debugging?" prompt on the TV ("Always allow"). Then press Home on the remote: if the TV asks which home app to use, choose Lume and Always.
Some TVs ignore that and keep opening their own launcher. As a last resort, disable the stock launcher together with the recommendations service (nothing is deleted):
adb shell pm disable-user --user 0 com.google.android.tvlauncher
adb shell pm disable-user --user 0 com.google.android.tvrecommendations
To go back to the stock launcher:
adb shell pm enable com.google.android.tvlauncher
adb shell pm enable com.google.android.tvrecommendations
adb uninstall app.lume.tv
Way 2: ask Claude
If you use Claude Code (or another AI assistant that can run commands on your computer), you don't have to type any of that. With debugging already on, just ask:
Install the Lume launcher on my Android TV following the README at
https://github.com/douglaspands/lume-tv-launcher. Download the APK from the
latest release, ask me for the TV's IP address, and ask for my confirmation
before any command that changes the TV.
It reads the repo's guide, checks that adb is installed (and tells you how to get it if not), downloads the APK, asks for your TV's IP, connects, installs and sets Lume as the home screen, asking for your confirmation before anything that changes the TV. The README also has a more detailed prompt ready to copy.
Thanks for reading. Let's make our TVs lighter together.