FR
live

CleanYourTV strips ads from any Android TV over Wi-Fi ADB, with no root and nothing uninstalled

Born from a 7.4 million-view tweet on October 17, 2026, CleanYourTV disables ads and bloatware on an Android TV or Google TV over Wi-Fi ADB, then installs a minimal 523 KB Apple TV-style launcher. Nothing is uninstalled and a script restores everything in one line; only Fire TV and a few China-market TCL sets remain partially covered.

A flat-screen television mounted in a dark living room, its screen showing a dark grid of identical tiles with a single amber tile lit.

October 17, 2026. Gathin23 posts a before-and-after of his parents’ TV, cleaned by Claude Code over Wi-Fi: 7.4 million views. October 19, 2026. The repo, first called tv-vibehack, becomes CleanYourTV. October 25, 2026. The project passes 38,000 stars and lists 316 TV models across 89 brands, topping the GitHub weekly chart. The point that matters: cleaning your television of ads no longer requires root, a cable or alternative firmware — only the debug bridge Android already ships.

For the self-hosting crowd, it is the same reflex as a NAS or a Pi-hole: taking back control of a device you own that is working against you.

The mechanism: ADB, pm disable-user and a launcher

Android TV and Google TV sets ship the same debug bridge as Android phones: ADB. Enable USB debugging in developer options, authorise the computer once, and everything else is standard Android tooling:

bash
# 1. Enable debugging on the TV, then connect over Wi-Fi
adb connect 192.168.1.42:5555
# 2. Disable an ad package (equivalent to Settings > Apps > Disable)
adb shell pm disable-user --user 0 com.google.android.apps.tv.launcherx
# 3. Restore the original state in one line
./tools/restore.sh

Nothing is uninstalled: pm disable-user disables the package, and tools/restore.sh re-enables everything. The project also ships tools/disable.sh and launcher/build-and-install.sh, which hold the backup, the home-screen guard and the restore record. That is the difference from a homegrown script: the coding assistant reuses these tools instead of improvising.

The tricky part varies by brand, so the prompt has your assistant discover the bloatware on your TV and ask before touching anything you might use. Bloat differs between TCL, Sony, Xiaomi and Philips, the four most-represented brands in the lists.

What you get: a home screen that gets out of the way

The installed launcher is a native app of about 523 KB, under the MIT licence, that replaces the home screen with a dock of four favourite apps, a top shelf that names the focused app with an ambient glow, and a grid for the rest. No sponsored rows, no “Discover” nags, no telemetry phoning home.

The TV becomes a screen again: it shows what you ask for, and nothing else. Three frosted buttons expose the HDMI inputs, the network and the settings. Themes change colours, wallpaper and column count without a rebuild.

The limits, without the spin

The project is honest about what it does not do. On Fire TV, only the debloat half works: Fire OS will not hand the home screen to a third-party launcher. On a handful of China-market TCL sets, the TV refuses to install any launcher at all. Samsung (Tizen) and LG (webOS) are out of scope — they are not Android systems.

It also has to be said: modifying a TV’s software can affect its warranty. The project insists on its honesty — no root, no flashed firmware, no DRM bypass, only the settings the TV offers its owner — but the contractual risk is real. Finally, watch for clones: the official site is cleanyour.tv, and other domains using the name are not run by the project.

Why it matters beyond the living room

CleanYourTV is more than a viral gadget. It is the first time a TV debloat tool has reached this scale — 38,000 stars, tens of thousands of TVs cleaned, press coverage in 197 articles across 32 countries. And it is a product of “vibe coding”: Claude Code cleaned a real TV, iterating with screenshots, while its author steered. The same reflex that pushes people to self-host their data now extends to the last screen the platforms were monetising.

It is also an answer to “open core” fatigue: when free tools close up or monetise, an MIT project that hands a device back to its owner becomes a symbol.

Without a computer: the community app and the guard rail

The “official” path assumes a computer on the same Wi-Fi and a coding assistant with shell access — Claude Code, Codex or Gemini CLI. The assistant backs up, debloats, builds and installs the launcher, checking each step with screenshots pulled from the TV. With the repo as context, budget about fifteen minutes. If you only have an Android phone, the community app Clean Your TV by @udhaykumarbala does the job in five minutes: connect, analyse, clean.

The clever part is the home-screen guard: before disabling the stock launcher, the script installs and switches to the replacement, then verifies it responds — so the TV is never left without a home screen. And nothing is lost: a long press on a tile moves it, and the app library puts a removed app back on Home with one press. On the 2015 Fire TV Box (Fire OS 5), by contrast, even the debloat half fails: every pm route is refused.

Why neither a Pi-hole nor a bare launcher is enough

Other paths lead to a less intrusive TV, and they do not solve the same problem. A Pi-hole or AdGuard Home blocks ad requests at the network level — but it does not remove the sponsored rows on the home screen, which the system serves, or the preinstalled telemetry packages. A hand-installed alternative launcher hides the ads but leaves the analytics services running in the background, still collecting.

CleanYourTV does both: it disables the telemetry and ad packages and installs a launcher that does not resurface them. That combination — disabling at the system level rather than just masking — is what makes it effective, with no root or alternative firmware. And it is also what makes it a symbol: an MIT tool, steerable by a coding agent, that hands a TV back to its owner, just as the satire site Open is the New Closed mocks projects that open up only to close down again.

The numbers tell the story of demand: 316 TV models across 89 brands, contributions in 28 languages, and press coverage in 197 articles from 32 countries. When a debloat tool earns that reach in under ten days, it is not a niche hack — it is a market signal that people want their screens back. The fact that a single before-and-after post reached 7.4 million views and then scaled through community-submitted per-model lists says the bottleneck was never technical skill — it was a recipe people could trust. CleanYourTV is that recipe, and it ships as a repo, not a service.

Verdict

If your TV runs Android TV or Google TV, run CleanYourTV this weekend: fifteen minutes, a computer on the same Wi-Fi, and you get an ad-free home screen with a one-line restore if you change your mind. If you are on Fire TV, use only the debloat half and keep the stock launcher. If you are on Samsung or LG, move on — this is not for those systems. The verdict fits in one sentence: it is the most complete TV debloat tool to date, and it works because it installs nothing irreversible.

References

The cyber brief, every Tuesday

The flaws that matter and the patches to apply, in a ten-minute read.

No spam. One-click unsubscribe.
read next

On the same topic

PatchMon turns Linux patch day into a single approval queue, without the SSH crawl

On October 23, 2026, the selfh.st newsletter spotlighted PatchMon, an AGPL v3 self-hosted patch-management platform that drives Linux, FreeBSD, and Windows updates from one queue with dry-run, approval, and audit. For fleets beyond a few dozen machines that must answer to auditors, it replaces the SSH crawl and homegrown playbooks.

← Back to the feed

Type at least two characters.

↑ ↓ navigate ↵ open esc dismiss