Gathin23

cleanyourtv: Debloat Android TVs and Replace the Home Screen

CleanYourTV uses Android's ADB tools to disable unwanted apps and services over Wi-Fi, then installs a lightweight Apple TV-style launcher. It is for Android TV and Google TV owners who want fewer ads and more control without rooting or uninstalling packages.

Stars
59.4k
Forks
7.8k
Last commit
today
Contributors
100+
Releases, 12 months
13

Our take

Newless than six months old and changing fast

Health score

70/100

How it is scored
Activity
76
Community
72
Issues
68
Pull requests
63
  • Merges more pull requests than 91% of the projects we track
  • More contributors than 78% of the projects we track

CleanYourTV is a rapidly developing, actively maintained toolkit with broad community participation, but its device-specific changes call for careful, model-aware use.

Good fit if

  • You own an Android TV or Google TV and can enable ADB debugging and connect a computer over Wi-Fi.
  • You want reversible package disabling plus a replacement launcher, and are willing to follow the model-specific checks.
  • You value a project that has recently shipped releases and merged contributions from a broad contributor base.

Look elsewhere if

  • Your TV runs Tizen, webOS, Roku, VIDAA or another platform without the required ADB support.
  • You want a ready-to-install app-store package: the repository says it publishes no app-store app or prebuilt launcher APK.
  • You need the replacement launcher on Fire TV, where the project supports debloating only.
All health signals
Last commit2026-11-18 (today)
Commits, last 90 days100+
Releases, last 12 months13 (latest v3.5.0, 2026-11-14)
Contributors100+ (top contributor: 66% of commits)
Issues closed, last 90 days5+ (typically closed in 1 day)
Pull requests merged, last 90 days87 (typically merged in 1 day)
Project age33 days

Checked on 2026-11-19 with the GitHub API.

Overview

CleanYourTV is a Python toolkit built on Android's ADB debugging interface. It helps Android TV and Google TV owners disable manufacturer apps, telemetry and ad services over Wi-Fi, then replace the stock home screen with a small Apple TV-style launcher. The project frames its approach around avoiding root access and package uninstallation, with scripts to restore the TV's previous state.

It is aimed at people comfortable enabling developer options and running commands on a computer, or using a coding assistant to guide the setup. The debloating tools also work on Fire TV, but the replacement launcher does not. TVs without Android or Fire OS ADB support, including Samsung Tizen, LG webOS and Roku, are outside the project's scope.

Key Features

  • Applies model-specific debloat lists by disabling packages with Android's package manager, rather than uninstalling them.
  • Records the TV's state and provides restore scripts to re-enable packages and return Home to its previous launcher.
  • Includes a native launcher with a dock, app grid, themes, optional app library and a clock screensaver.
  • Provides a Python ADB client for shell commands, file transfers and screenshots, including support for paired Wireless debugging.
  • Includes tools to inspect privacy-related package candidates and compare the TV with a debloat list after firmware updates.
  • Maintains contributed device lists across Android TV and Google TV models and brands.

Use Cases

  • An Android TV owner wants to disable sponsored content and preloaded apps while keeping a way to restore them.
  • A household wants a simpler home screen and is willing to build and install the launcher using Android development tools.
  • A contributor has a TV model not yet covered and wants to document a tested debloat list for other owners.
  • A Fire TV owner wants to apply supported package disables but does not expect to replace Fire OS's home screen.

What you need

Detected in the repository

  • Python (main language on GitHub)
  • A test suite and automated checks on GitHub Actions

Getting Started

Enable USB debugging in the TV's developer options, connect the TV and computer to the same Wi-Fi, then clone the repository and follow its prompt:

git clone https://github.com/Gathin23/cleanyourtv

See the README for prerequisites, setup instructions, supported models, and manual commands.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Considerations

  • The project is new and changing quickly. Recent activity is high, with frequent commits and releases and contributions from many people, but its short history means device lists and behavior may still evolve.
  • Compatibility depends on TV firmware and manufacturer. Some models refuse third-party launchers, and Fire TV does not hand Home to one. A firmware update can restore disabled packages or change the home screen, so the project provides a comparison and repair tool.
  • Setup requires network ADB and, for building the launcher, Python, a JDK in the documented range and Android SDK platform 34 with build-tools 34. The README warns that network ADB can expose a plaintext shell on the local network and advises turning debugging off when finished.
  • Disabling a package the TV depends on can disrupt functions. The project includes restore safeguards, but advises applying lists carefully; a factory reset may be needed if the TV cannot start far enough to restore settings.
  • The README states that the project is MIT-licensed, while the supplied repository license metadata is marked NOASSERTION. Confirm the license file and any applicable terms before incorporating code into another project.

Found this useful?

Share it with someone who would like cleanyourtv.