https://github.com/leanbitlab/flauncherl
A minimal, open-source Android TV launcher featuring WiFi data usage widget, an inbuilt OLED friendly screensaver, and improved UX. A customized fork of FLauncher.
https://github.com/leanbitlab/flauncherl
android android-tv customization dart flutter launcher leanback minimal no-ads open-source
Last synced: 2 months ago
JSON representation
A minimal, open-source Android TV launcher featuring WiFi data usage widget, an inbuilt OLED friendly screensaver, and improved UX. A customized fork of FLauncher.
- Host: GitHub
- URL: https://github.com/leanbitlab/flauncherl
- Owner: LeanBitLab
- License: gpl-3.0
- Created: 2026-01-16T09:17:29.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-01-17T14:05:27.000Z (3 months ago)
- Last Synced: 2026-01-20T20:10:25.627Z (3 months ago)
- Topics: android, android-tv, customization, dart, flutter, launcher, leanback, minimal, no-ads, open-source
- Language: Dart
- Size: 11.1 MB
- Stars: 13
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# LTvLauncher
[](https://github.com/LeanBitLab/FlauncherL/releases/latest) [](https://github.com/LeanBitLab/FlauncherL/releases) [](https://github.com/LeanBitLab/FlauncherL/stargazers)
**LTvLauncher** is a fork of [FLauncher](https://github.com/osrosal/flauncher) (originally by [etienn01](https://gitlab.com/flauncher/flauncher)) - an open-source alternative launcher for Android TV.
This customized version introduces usability enhancements and some UX improvements by [LeanBitLab](https://github.com/LeanBitLab).
## Key Features & Enhancements
- **Data Usage Widget** - Track daily Internet consumption directly from the status bar.
- **Inbuilt OLED Screensaver** - Minimal screensaver with 30s clock position shifting to prevent burn-in.
- **Easy WiFi Access** - Network indicator doubles as a shortcut to system WiFi settings.
- **Quick Presets** - Select Time/Date formats and Category names from a list (No keyboard required).
- **Pitch Black Wallpaper** - Added a true black gradient background option.
- **Enhanced Focus Indicator** - New double-border design ensures perfect visibility on any background.
- **Smart Navigation** - Fixed "bounce back" issues and optimized focus traversal for a smoother experience.
- **Refined Settings** - Reorganized menus with a new "Miscellaneous" section and unified focus styles.
- **Accent Color Support** - Personalize the UI with multiple color presets.
- **Improved Sorting** - Easily reorder categories using Left/Right arrow keys instead of finicky gestures.
- **Left Side Settings** - Reorganized settings panel now opens on the left for better reach.
- **Brightness Scheduler (Experimental)** - Automatically adjust system brightness based on time of day (Requires `WRITE_SETTINGS` permission via ADB).
- **New Category** - Added "Favorites".
- **Optimizations** - Improved performance with aggressive icon caching and code cleanups.
> [!WARNING]
> **Brightness Scheduler is an experimental feature.** It is currently untested across all devices and may be removed or modified in future versions based on user feedback.
## Screenshots
Home Screen
Settings 1
Settings 2
Settings 3
Screensaver
## Original FLauncher Features
- [x] No ads
- [x] Customizable categories
- [x] Manually reorder apps within categories
- [x] Wallpaper support
- [x] Open "Android Settings"
- [x] Open "App info"
- [x] Uninstall app
- [x] Clock
- [x] Switch between row and grid for categories
- [x] Support for non-TV (sideloaded) apps
- [x] Navigation sound feedback
## Set LTvLauncher as default launcher
### Method 1: Remap the Home button
This is the "safer" and easiest way. Use [Button Mapper](https://play.google.com/store/apps/details?id=flar2.homebutton) to remap the Home button of the remote to launch LTvLauncher.
### Method 2: Disable the default launcher
**:warning: Disclaimer :warning:**
**You are doing this at your own risk, and you'll be responsible in any case of malfunction on your device.**
The following commands have been tested on Chromecast with Google TV only. This may be different on other devices.
Once the default launcher is disabled, press the Home button on the remote, and you'll be prompted by the system to choose which app to set as default.
#### Disable default launcher
```shell
# Disable com.google.android.apps.tv.launcherx which is the default launcher on CCwGTV
$ adb shell pm disable-user --user 0 com.google.android.apps.tv.launcherx
# com.google.android.tungsten.setupwraith will then be used as a 'fallback' and will automatically
# re-enable the default launcher, so disable it as well
$ adb shell pm disable-user --user 0 com.google.android.tungsten.setupwraith
```
#### Re-enable default launcher
```shell
$ adb shell pm enable com.google.android.apps.tv.launcherx
$ adb shell pm enable com.google.android.tungsten.setupwraith
```
#### Known issues
On Chromecast with Google TV (maybe others), the "YouTube" remote button will stop working if the default launcher is disabled. As a workaround, you can use [Button Mapper](https://play.google.com/store/apps/details?id=flar2.homebutton) to remap it correctly.
## Wallpaper
Because Android's `WallpaperManager` is not available on some Android TV devices, FLauncher implements its own wallpaper management method.
Please note that changing wallpaper requires a file explorer to be installed on the device in order to pick a file.
## Credits
### Original Projects
- **[FLauncher](https://gitlab.com/flauncher/flauncher)** by [etienn01](https://github.com/etienn01) - The original project
- **[FLauncher (Fork)](https://github.com/osrosal/flauncher)** by [osrosal](https://github.com/osrosal) - The base for this fork
---
### LTvLauncher
- Customizations by [LeanBitLab](https://github.com/LeanBitLab)