CocoCR300 / flauncher

Fork of https://gitlab.com/flauncher/flauncher
GNU General Public License v3.0
32 stars 3 forks source link

FLauncher (fork)

This is a fork of the GitLab repository at: https://gitlab.com/flauncher/flauncher.

FLauncher is an open-source alternative launcher for Android TV, built with Flutter.

Download

Get the latest build from the releases page, you can look for older builds on the actions tab, where they are uploaded as artifacts.

Features

For a list of the changes introduced by this fork from the original, see the CHANGELOG file.

Screenshots

Set FLauncher 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 FLauncher.

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

# 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.

Support the original author: etienn01

Buy Me A Coffee