RSS
Tools

CleanYourTV: debloat an Android TV or Google TV over Wi-Fi with Claude Code and get an Apple TV-style home screen

CleanYourTV (Gathin23/cleanyourtv) switches off the ad services, sponsored rows, telemetry and preloaded apps on an Android TV or Google TV over Wi-Fi and installs a small Apple TV-style launcher. You run it by pasting a prompt into Claude Code or another coding assistant. MIT, 58,000+ stars.

Black flat screen TV near a wooden shelf, illustrating CleanYourTV debloating Android and Google TV
Photo by Jonas Leupe on Unsplash

CleanYourTV is an open-source project that switches off the ad services, sponsored rows, telemetry and preloaded apps on an Android TV or Google TV over Wi-Fi, and installs a small home screen modelled on Apple TV's. It lives on GitHub at Gathin23/cleanyourtv, is MIT-licensed, and had about 58,100 stars and 7,600 forks on November 15, 2026, less than a month after its first commit on October 17. It started with the developer's parents' TV, cleaned up by Claude Code, according to the README; TechCrunch covered it on October 19.

There is no app to download. The README hands you a prompt (PROMPT.md) to paste into a coding assistant such as Claude Code, Codex or Gemini CLI, and the assistant does the work on your TV with the repo's scripts. If contributors have already tested a list for your model, it uses that; otherwise it discovers the bloat on your TV and asks before touching anything you might use.

Quick facts

  • Works on: Android TV and Google TV; the launcher needs Android 8.0 (API 26) or newer.
  • Fire TV: the debloat only, since Fire OS keeps the Home button. On the 2015 Fire TV Box (Fire OS 5) even that fails.
  • Not supported: Samsung (Tizen), LG (webOS), Roku, Vizio and Hisense VIDAA, which have no ADB; the project points them to cleanyour.tv/not-android.
  • Licence and cost: MIT, free. Latest release v3.5.0 (November 14, 2026), with no binaries: you build the launcher.
  • On the computer: Python 3, a JDK from 17 through 22, and Android SDK platform 34 with build-tools 34, or just Docker via tools/docker-build.sh.
  • Coverage: 481 tested TV models from 131 brands, per the README.
  • Official sites: the GitHub repo and cleanyour.tv only; the README says cleanyourtv.com and clean-your-tv.net are not the project's, and it has no app in any store.
  • Independent: not affiliated with any TV maker, per the README's Legal section, which adds that you run it at your own risk and that changing a TV's software may affect its warranty or support.

How it works

Android TVs carry the same debug bridge (ADB) as Android phones. Once you switch on USB debugging in the TV's developer options and allow your computer once, the job is three steps, per the README: back up the package list and settings, disable the maker's telemetry, ad services and preloaded apps with pm disable-user, and install the new launcher as the default home screen.

Nothing is uninstalled, rooted or flashed, so tools/restore.sh can undo every step from a record that tools/disable.sh writes to ~/.cleanyourtv/ before changing anything. The scripts also guard Home: they only disable a stock launcher they recognise, and only once another launcher answers HOME, so the TV is never left with nothing to start.

How to install

With a coding assistant, the README's quick start is three steps and takes about fifteen minutes by the project's estimate:

  • On the TV: Settings, Device Preferences, About, press OK on Build seven times, then turn on USB debugging in Developer options (and Network or ADB debugging if the TV shows it).
  • On the computer, on the same Wi-Fi: git clone https://github.com/Gathin23/cleanyourtv, open that folder in your assistant, paste PROMPT.md and fill in your TV model.
  • Accept the Allow USB debugging prompt on the TV, then answer the assistant's checklist: which apps you use, the dock size and order, and whether to keep the voice assistant, Chromecast and firmware updates.
  • If port 5555 stays closed, as on many Google TV sets, the README describes pairing through Wireless debugging with a code first. PROMPT.md also warns that some boxes cut power to their USB port while USB debugging is on, so a USB Ethernet adapter can drop: do the job in one sitting.

Cloning matters. The README says the assistant should reuse the repo's tools/disable.sh and launcher/build-and-install.sh instead of writing its own, because the backup, the Home guard and the restore record live in those scripts.

Without an assistant, the README's Doing it by hand section has the same job as commands (tools/tv.py --probe, tools/disable.sh with a list from examples/, launcher/build-and-install.sh), each with a PowerShell twin for Windows. Without a computer, it lists four free, independent apps built on the project's TV lists, for Android phones, Mac and Windows, and says they are not affiliated with the project.

What you get

  • A black home screen with a dock of four favourite apps, a top shelf that names the focused app, and the rest of your apps in a grid below.
  • A launcher of about 572 KB in plain Java, built for TVs with 1 GB of RAM; the README says it has no network permission and no background services.
  • Themes pushed over Wi-Fi without a rebuild (29 at v3.5.0), 31 interface languages, an Inputs button for HDMI and Live TV, and remote keys such as Input and YouTube kept working.
  • Tools for later: tools/check.py shows what a firmware update undid and --fix puts it back; tools/privacy.py lists voice, ACR and telemetry candidates with the evidence for each.

CleanYourTV or Free My TV?

Earlier today we covered Free My TV (simbasjungles/free-my-tv), another open-source home screen for TVs built with Claude Code. It attaches a ready APK to its GitHub releases and also runs as an app on LG and Samsung TVs. CleanYourTV ships no binaries: the full job is for Android TV and Google TV, with only the debloat half on Fire TV, and the launcher is built on your computer. Free My TV is quicker to install; CleanYourTV gives you a per-package list to approve and a record to restore from.

How it was built with Claude

Of the 6,339 commits on the main branch on November 15, 1,078 carry a Claude Co-Authored-By line, the first on October 18, the day after the initial commit. Most name Claude Opus 5.5 (882, plus 26 for Opus 5.5 with 1M context), followed by Claude Sonnet 5.5 (78). Smaller numbers credit Cursor and GitHub Copilot. The maintainer, Gathin23, authored 2,930 commits; the v3.5.0 notes count 355 pull requests from 152 people in the nine days since v3.4.0.

The repo's CLAUDE.md just points Claude Code at AGENTS.md (with an @AGENTS.md import), a guide of about 2,500 words shared by every coding agent the project supports. It splits the work in two: an agent cleaning a TV must follow PROMPT.md on the real device and change only the launcher's config.xml or a theme, while an agent changing the repo reads the rest. Its safety rules read like lessons learned: disable, never uninstall; one package per shell call; never start a factory or test package, because on some boards that flips a flag the shell cannot undo; never disable Android core packages, which tools/disable.sh refuses with no override after a TV failed to boot (issue #884).

Try it with your AI. Want to see what your Android or Google TV would lose before changing anything? This prompt keeps the assistant to read-only steps from the project's own tools.

I want to audit my Android TV / Google TV with the CleanYourTV project before changing
anything. My TV model is [TV MODEL] and its IP address on my Wi-Fi is [TV IP].

I have already turned on USB debugging (and Network/ADB debugging if the TV has it) in
Developer options. When the TV shows Allow USB debugging, tell me and wait while I
accept it.

1. Check that this computer has Python 3 and git, and that this folder is a clone of
   https://github.com/Gathin23/cleanyourtv. If not, clone it and work there. Do not
   write your own ADB tools.
2. If tools/venv does not exist yet, create it: python3 -m venv tools/venv, then
   tools/venv/bin/pip install -r tools/requirements.txt.
3. With TV_HOST=[TV IP] set, run tools/venv/bin/python -I tools/tv.py --probe and show
   me the model, Android version and firmware.
4. Run tools/venv/bin/python -I tools/tv.py 'pm list packages' > packages.txt, then
   tools/venv/bin/python -I tools/match.py packages.txt. Summarise it, and remember
   these are counts across other people's lists, not a recommendation for my TV.
5. Look up my model in examples/README.md and show me its debloat.txt if one exists.

Run no command on the TV other than the two above. In particular, no disable.sh,
restore.sh, build-and-install.sh, pm disable, pm uninstall or settings command, and
never start a factory or test app. Show me the findings and wait. At the end, remind me
to turn USB, network and wireless debugging off.

Known limits

  • ADB is a door into the TV. Network ADB is plaintext on port 5555, and on firmware with ro.adb.secure=0 (or unset) any device on the network gets a shell, per the FAQ. The README says to turn off USB, network and wireless debugging when you are done, revoke the authorisations, reboot, and confirm with tools/adb-closed.py that the port is closed.
  • Firmware updates undo the work: packages come back and Home returns to the stock launcher. Reopen ADB and run tools/check.py with --fix.
  • On Google TV, the setup wizard (setupwraith) can take Home and crash-loop the system once the stock launcher is off. If it owns the saved Wi-Fi network, disabling it deletes that network, and on Chromecast and Google TV Streamer it also costs phone casting.
  • Ads inside apps stay. The FAQ suggests Private DNS with an ad-blocking resolver for some, notes that resolver then sees every DNS query, and says YouTube ads are not removed.
  • A few China-market TCL sets refuse any launcher, and on macOS, Local Network privacy can block the connection until you allow your terminal app.
  • If a disabled package breaks the TV badly, the FAQ says a factory reset from the recovery menu is usually the way back, and it also wipes your own apps and accounts.

Problems and feedback

Bugs and TV-specific reports go to the repository's GitHub issues (about 250 open issues and pull requests on November 15). Security problems should not go in a public issue: SECURITY.md asks for GitHub's private vulnerability reporting. To add a tested list for your model, CONTRIBUTING.md explains the folder format in examples/.

FAQ

Does CleanYourTV need root? No. The README says nothing is rooted, flashed or uninstalled; packages are disabled for the user and a restore script undoes them.

Is there a CleanYourTV APK or app store app? No. The project publishes no app in any store and attaches no binaries to its releases. The launcher is built from source by the install script, or in Docker.

How do I undo it? Run tools/restore.sh with the debloat list you applied, adding com.google.android.apps.tv.launcherx on Google TV. The new launcher stays installed until you remove it in Settings, Apps.

Can I clean a TV in another home? The README says yes, over a private Tailscale link, and never by opening the TV's ADB port on the router.

Source: GitHub: Gathin23/cleanyourtv, CleanYourTV releases, CleanYourTV AGENTS.md, CleanYourTV FAQ, TechCrunch: People are using AI to make their smart TVs dumb again, GitHub: simbasjungles/free-my-tv

This story first appeared in the claudefox daily briefing for November 15, 2026.