Repolode
Submit
techgenius1

techgenius1/tvOS-Launcher

A tvOS 26 and macOS-inspired home screen launcher for Android TV and Google TV, written in pure Java with no third-party runtime dependencies.

View on GitHub
Stars
334
Forks
21
Open issues
1
Last commit
3 days ago

What is it?

tvOS Launcher replaces the home screen on Android TV and Google TV with a layout inspired by Apple's tvOS 26 and macOS. It offers a Liquid Glass dock, rotating night-scene wallpapers with a large clock, and a classic app grid mode. Users can rename apps, change their icons from JPG, PNG or ICO files, move apps into an overflow folder, or hide them.

The project also includes a universal Control Panel overlay that can be opened over any running app, a Recent Apps switcher with a RAM readout, and a remote button mapper that assigns different actions to single, double and triple taps. Setup can be automated over local ADB at 127.0.0.1:5555, which grants the default-home, accessibility and other permissions in one step. A built-in CleanYourTV-based debloater offers 341 device profiles for disabling bundled apps on the TV itself.

The launcher supports Android 7.0 (API 24) and later, is localized into 13 languages, and can run up to three user profiles. Weather comes from Open-Meteo, MET Norway or wttr.in without an API key.

Key features

  • 01Liquid Glass dock with rotating night-scene wallpapers and a large clock
  • 02Rename, re-icon, move, hide or uninstall apps by holding OK
  • 03Universal Control Panel overlay available over any running app
  • 04Recent Apps switcher showing RAM usage with a Close All option
  • 05Remote button mapper for 1x, 2x and 3x taps
  • 06One-tap permission setup over local ADB

Use cases

  • Replacing the stock Android TV home screen with a macOS or tvOS-style interface
  • Running on older or low-memory TV boxes that need a lightweight launcher
  • Removing preinstalled bloatware from a TV without a PC
  • Mapping remote buttons to quick access to settings or recent apps

Quick start

  1. 1

    Install the JDK 17+ and the Android SDK with build-tools 34.0.0 and platform android-34

  2. 2

    Build the APK on macOS or Linux

    ./build.sh
  3. 3

    Connect to your TV over ADB

    adb connect <tv-ip>:5555
  4. 4

    Install the APK on the TV

    adb install -r build/tvos-home.apk

Things to know

  • Installing from source requires the JDK and Android SDK, and the README's Windows and macOS/Linux build scripts differ.
  • Automatic permission setup and the CleanYourTV debloater depend on Local ADB, and the debloater is marked Beta.

Topics

#android-tv#launcher#google-tv#java#adb#home-screen#remote-control

FAQ

What is tvOS-Launcher?
A tvOS 26 and macOS-inspired home screen launcher for Android TV and Google TV, written in pure Java with no third-party runtime dependencies. tvOS Launcher replaces the home screen on Android TV and Google TV with a layout inspired by Apple's tvOS 26 and macOS. It offers a Liquid Glass dock, rotating night-scene wallpapers with a large clock, and a classic app grid mode. Users can rename apps, change their icons from JPG, PNG or ICO files, move apps into an overflow folder, or hide them.
Is tvOS-Launcher free to use? What license does it have?
tvOS-Launcher is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is tvOS-Launcher still maintained?
Actively maintained. The last commit to tvOS-Launcher was on Nov 4, 2026.
What can I use tvOS-Launcher for?
Replacing the stock Android TV home screen with a macOS or tvOS-style interface Running on older or low-memory TV boxes that need a lightweight launcher Removing preinstalled bloatware from a TV without a PC Mapping remote buttons to quick access to settings or recent apps
How do I install tvOS-Launcher?
Install the JDK 17+ and the Android SDK with build-tools 34.0.0 and platform android-34 Build the APK on macOS or Linux: ./build.sh Connect to your TV over ADB: adb connect <tv-ip>:5555 Install the APK on the TV: adb install -r build/tvos-home.apk
Where can I get tvOS-Launcher?
The source code and installation instructions are on GitHub: https://github.com/techgenius1/tvOS-Launcher

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects