Skip to content

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.

License

Notifications You must be signed in to change notification settings

LeanBitLab/FlauncherL

Repository files navigation

FlauncherL

FlauncherL Banner

Download Downloads Stars

FlauncherL is a fork of FLauncher (originally by etienn01) - an open-source alternative launcher for Android TV.

This customized version introduces usability enhancements and some UX improvements by 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.
  • New Categories - Added "Favorites" with add from home support.
  • Optimizations - Improved performance with aggressive icon caching and code cleanups.

Screenshots

Home Screen Settings Widget Screensaver
Home Screen Settings Widget Screensaver

Original FLauncher Features

  • No ads
  • Customizable categories
  • Manually reorder apps within categories
  • Wallpaper support
  • Open "Android Settings"
  • Open "App info"
  • Uninstall app
  • Clock
  • Switch between row and grid for categories
  • Support for non-TV (sideloaded) apps
  • Navigation sound feedback

Set FlauncherL as default launcher

Method 1: Remap the Home button

This is the "safer" and easiest way. Use Button Mapper to remap the Home button of the remote to launch FlauncherL.

Method 2: Disable the default launcher

⚠️ Disclaimer ⚠️

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

# 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

$ 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 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


FlauncherL

About

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.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages