Repolode
Submit
Gathin23

Gathin23/cleanyourtv

Removes bloatware from Android TV and Google TV over Wi-Fi via ADB and replaces the home screen with a lightweight Apple TV-style launcher.

View on GitHubWebsite
Stars
6,121
Forks
738
Open issues
73
Last commit
11 hours ago

What is it?

CleanYourTV is a tool for debloating Android TV and Google TV sets over Wi-Fi. It connects to the TV through ADB, backs up the installed package list, and disables manufacturer telemetry, ad services, sponsored content rows and preloaded apps with pm disable-user. Nothing is uninstalled and root is not required, so a restore script can re-enable every change.

The project also includes a small native Android TV launcher in plain Java, about 250 KB installed, that replaces the default home screen with a dark layout featuring a dock, a focused-app header, and an app grid. It supports themes pushed as config files without rebuilding, configurable dock and columns, and optional module cards that let other apps add tiles.

A PROMPT.md file lets a coding assistant such as Claude Code discover the bloat on a specific TV model and walk through the process. Python and shell scripts handle ADB, debloat lists, restores and launcher installs, and PowerShell equivalents are provided for Windows. Community-contributed debloat lists cover many models from Xiaomi, TCL, Sony, Hisense and others.

Key features

  • 01Disables preloaded apps, ad services and telemetry over ADB without uninstalling anything
  • 02Requires no root and no cable, only Wi-Fi and USB debugging on the TV
  • 03Restore script re-enables the listed packages and brings back the stock launcher
  • 04Lightweight replacement launcher with a dock, app grid and themeable colours
  • 05Module cards let other apps add tiles with user approval
  • 06Works on Windows via PowerShell scripts and on macOS or Linux via shell scripts

Use cases

  • Removing sponsored rows and ads from a family member's Google TV or Android TV
  • Cleaning up a bloated Xiaomi, TCL or Sony TV that ships with many preloaded apps
  • Replacing the stock home screen with a simpler, faster launcher on a low-RAM set
  • Using a coding assistant to debloat a TV model that has no existing list

Topics

#android-tv#google-tv#adb#debloat#launcher#smart-tv#home-screen#ad-free#android-tv-launcher#bloatware-removal

FAQ

What is cleanyourtv?
Removes bloatware from Android TV and Google TV over Wi-Fi via ADB and replaces the home screen with a lightweight Apple TV-style launcher. CleanYourTV is a tool for debloating Android TV and Google TV sets over Wi-Fi. It connects to the TV through ADB, backs up the installed package list, and disables manufacturer telemetry, ad services, sponsored content rows and preloaded apps with pm disable-user. Nothing is uninstalled and root is not required, so a restore script can re-enable every change.
Is cleanyourtv free to use? What license does it have?
cleanyourtv is open source under the Other license. Check the license terms before using it in commercial products.
Is cleanyourtv still maintained?
Actively maintained. The last commit to cleanyourtv was on Oct 20, 2026.
What can I use cleanyourtv for?
Removing sponsored rows and ads from a family member's Google TV or Android TV Cleaning up a bloated Xiaomi, TCL or Sony TV that ships with many preloaded apps Replacing the stock home screen with a simpler, faster launcher on a low-RAM set Using a coding assistant to debloat a TV model that has no existing list
Where can I get cleanyourtv?
The source code and installation instructions are on GitHub: https://github.com/Gathin23/cleanyourtv

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

Related projects