Our take
Newless than six months old and changing fast- 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 commit | 2026-11-18 (today) |
|---|---|
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 13 (latest v3.5.0, 2026-11-14) |
| Contributors | 100+ (top contributor: 66% of commits) |
| Issues closed, last 90 days | 5+ (typically closed in 1 day) |
| Pull requests merged, last 90 days | 87 (typically merged in 1 day) |
| Project age | 33 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.