Repolode
Submit
seun-novodev

seun-novodev/android-tv-debloat-toolkit

Windows desktop app for Python-based ADB control of Android TV boxes: debloat, sideload APKs, and set up a custom launcher.

View on GitHub
Stars
745
Forks
25
Open issues
5
Last commit
4 months ago

What is it?

Android TV Toolkit is a lightweight Windows application for managing Android TV and Google TV devices over Wi-Fi using ADB. It offers a PySimpleGUI interface for removing TCL and Google bloatware, hiding Google TV recommendations, installing APK files remotely, and rebooting the TV.

The toolkit separates debloating into a Safe mode that removes common bloatware and an Advanced mode where each app carries a risk rating. Users can also disable the Google TV Launcher after installing a backup launcher such as FLauncher, and the Pair & Connect flow supports Android 11+ devices and Chromecast with Google TV through Wireless Debugging.

The project runs from Python source on Windows 10 or 11 with Python 3.8+. It is MIT licensed and is no longer actively maintained, though pull requests are accepted.

Key features

  • 01Connect to Android TV over Wi-Fi with ADB Wireless
  • 02Pair and connect to Android 11+ and Chromecast with Google TV via Wireless Debugging
  • 03Safe and Advanced debloat modes for TCL and Google bundled apps, with risk ratings
  • 04Remove Google TV recommendations
  • 05Install APK files to the TV remotely
  • 06Disable the Google TV Launcher after installing a custom launcher
  • 07Reboot the TV remotely

Use cases

  • Removing preinstalled TCL or Google apps from a new Android TV box
  • Sideloading apps like FLauncher onto a TV without a USB drive
  • Replacing the Google TV home screen with a lighter custom launcher
  • Managing several Android TV devices on a home network from one Windows PC

Quick start

  1. 1

    Install Python 3.8 or later from python.org

  2. 2

    Install the PySimpleGUI library

    pip install PySimpleGUI
  3. 3

    Download the project ZIP and unzip it

  4. 4

    Run the toolkit from the project folder

    python run_toolkit.py

Things to know

  • Windows 10 or 11 only.
  • Not actively maintained; updates and replies may be slow.
  • PySimpleGUI v5+ asks for a free account to suppress the licence prompt.

Topics

#adb#android-tv#debloat#apk#python#windows#launcher#custom-launcher#minimalist#opensource

FAQ

What is android-tv-debloat-toolkit?
Windows desktop app for Python-based ADB control of Android TV boxes: debloat, sideload APKs, and set up a custom launcher. Android TV Toolkit is a lightweight Windows application for managing Android TV and Google TV devices over Wi-Fi using ADB. It offers a PySimpleGUI interface for removing TCL and Google bloatware, hiding Google TV recommendations, installing APK files remotely, and rebooting the TV.
Is android-tv-debloat-toolkit free to use? What license does it have?
android-tv-debloat-toolkit is open source under the MIT license. Check the license terms before using it in commercial products.
Is android-tv-debloat-toolkit still maintained?
Updated within 6 months. The last commit to android-tv-debloat-toolkit was on Jun 28, 2026.
What can I use android-tv-debloat-toolkit for?
Removing preinstalled TCL or Google apps from a new Android TV box Sideloading apps like FLauncher onto a TV without a USB drive Replacing the Google TV home screen with a lighter custom launcher Managing several Android TV devices on a home network from one Windows PC
How do I install android-tv-debloat-toolkit?
Install Python 3.8 or later from python.org Install the PySimpleGUI library: pip install PySimpleGUI Download the project ZIP and unzip it Run the toolkit from the project folder: python run_toolkit.py
Where can I get android-tv-debloat-toolkit?
The source code and installation instructions are on GitHub: https://github.com/seun-novodev/android-tv-debloat-toolkit

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

Related projects