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.
Gathin23/cleanyourtv
Debloats Android TV and Google TV sets over Wi-Fi via ADB and replaces the ad-filled home screen with a clean Apple TV-style launcher.
- Stars
- 6,113
- Forks
- 735
- Open issues
- 25
- Last commit
- 15 hours ago
What is it?
CleanYourTV removes manufacturer bloatware, sponsored rows and preloaded apps from Android TV and Google TV sets without root or a cable. It connects over Wi-Fi using the standard ADB debug bridge and disables packages with pm disable-user, so nothing is uninstalled and a restore script can re-enable everything.
The project also includes a small native Android TV launcher (about 250 KB installed) written in plain Java with AndroidX RecyclerView. It provides a dock of favourite apps, a grid of the rest, configurable themes and columns, and an optional clock screensaver. The launcher is built for sets with 1 GB of RAM and runs no background services or network calls.
The repository is designed to be driven by a coding assistant with shell access, and it includes Python ADB tools, shell and PowerShell scripts, and example debloat lists for many TV models.
Key features
- 01Disables manufacturer bloat and ad services over ADB without root or uninstalling anything
- 02Generates a backup list so a restore script can re-enable every change
- 03Replaces the home screen with a native launcher featuring a dock and app grid
- 04Supports themes, configurable dock and columns, and multiple display languages
- 05Includes per-model example debloat lists for many Android TV and Google TV sets
Use cases
- Removing sponsored content and ads from a family member's Android TV or Google TV
- Cleaning up a new TV before first use while keeping an easy way to revert
- Replacing a cluttered stock home screen on a low-memory streaming box
- Reusing existing debloat lists for a TV model already documented in the repo
Quick start
- 1
Enable USB debugging on the TV via Developer options
- 2
Paste PROMPT.md into your coding assistant and enter your TV model
- 3
Accept the USB debugging prompt on the TV and answer the setup checklist
Things to know
- Supports only Android TV and Google TV; Samsung (Tizen), LG (webOS) and Fire TV are not fully supported.
- Some China-market TCL sets refuse to install any launcher.
- Requires a computer on the same Wi-Fi and a coding assistant with shell access for the easiest path.
- Metadata lists the license as NOASSERTION, so verify the license terms before reuse.
Topics
FAQ
- What is cleanyourtv?
- Debloats Android TV and Google TV sets over Wi-Fi via ADB and replaces the ad-filled home screen with a clean Apple TV-style launcher. CleanYourTV removes manufacturer bloatware, sponsored rows and preloaded apps from Android TV and Google TV sets without root or a cable. It connects over Wi-Fi using the standard ADB debug bridge and disables packages with pm disable-user, so nothing is uninstalled and a restore script can re-enable everything.
- 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 content and ads from a family member's Android TV or Google TV Cleaning up a new TV before first use while keeping an easy way to revert Replacing a cluttered stock home screen on a low-memory streaming box Reusing existing debloat lists for a TV model already documented in the repo
- How do I install cleanyourtv?
- Enable USB debugging on the TV via Developer options Paste PROMPT.md into your coding assistant and enter your TV model Accept the USB debugging prompt on the TV and answer the setup checklist
- 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
An open-source, ad-free home screen replacement for Google TV and Android TV that shows trending picks from your own apps, weather, and crypto prices.
A tvOS-style Android TV launcher for China-market TVs such as Xiaomi and TCL, with no ads and Apple TV aerial screensavers.
Windows desktop app for Python-based ADB control of Android TV boxes: debloat, sideload APKs, and set up a custom launcher.
Desktop app and PowerShell script to debloat, tune, and health-check Android TV devices such as Nvidia Shield TV over ADB.
Shell scripts that debloat Fire TV and Android TV sets over ADB without root, removing ads, telemetry and unwanted apps, all reversible.