← Back to blog
AiAbout 6 min read

Two Ways to Take the Ads Off a Smart TV, and 69,000 People Picked One

Published Nov 13, 2026
Two Ways to Take the Ads Off a Smart TV, and 69,000 People Picked One

A repository called cleanyourtv has picked up about 57,000 stars since October 17. A second one, aerial-tv, has about 11,600. They solve the same problem from opposite ends, and the fact that both blew up in the same month says something about how people feel about the television they bought.

The problem is the home screen. A TV from a Chinese manufacturer in 2026 boots into a page of recommendations, membership prompts, and preloaded apps, and the hardware underneath is usually fine. The remote is fine. The panel is fine. What is not fine is a launcher that treats the customer as inventory.

Approach one: turn it off

cleanyourtv does not replace anything. It connects to the TV over Wi-Fi and disables the manufacturer's telemetry, ad services, content rows, and preloaded junk with pm disable-user.

That command is the entire design philosophy. disable-user does not uninstall, so nothing is destroyed, and a restore script can put every package back. The tool backs up the installed package list and the settings first, then disables, then installs a small native launcher and sets it as the default home screen.

No root. No cable. No disassembly. No permanent change.

The quick start is where this stops looking like a normal open source project. You enable developer options on the TV, which means pressing OK on the Build entry seven times in the about screen and then turning on network debugging. Then, on your computer:

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

You open that folder in a coding assistant, paste PROMPT.md, and let it run. The assistant reuses the repository's own tools/disable.sh and launcher/build-and-install.sh, works through the steps, and verifies each one. The README estimates about fifteen minutes.

The manual path exists for people who want it, and it needs Python 3, a JDK between 17 and 22, and Android SDK platform 34. That toolchain is exactly the kind of thing that stops most people, which is presumably why the primary path is now "give this to your agent."

Approach two: build a new one

aerial-tv takes the other route. It is a Kotlin launcher, MIT licensed, that replaces the home screen with something modeled on an Apple TV: no ads, no recommendation feed, just your apps, a wallpaper, and an aerial screensaver.

It targets Xiaomi, TCL, Skyworth, and Sony televisions, and it also installs on streaming boxes and projectors. It runs on Android TV 5.0 and up, with a Lite beta for 4.0 through 4.4. Installation needs no root and touches no system apps, and it can be reverted.

The feature list is where the work went. The first row of apps sits on a glass shelf at the bottom of the screen, with the full grid below it, and it includes system apps that manufacturers hide, such as Xiaomi's app center and Mi Home. Long-pressing OK lets you move, folder, hide, or uninstall, and there is a "open this on boot" option so a television can wake directly into a specific app or input.

The part I did not expect is the phone workflow. Scan a QR code on the TV and your phone shows the same icon grid. Drag to reorder, tap to rename, change an icon, drop it into a folder, or add an HDMI input to the home screen. Renaming from a phone keyboard instead of a remote is the kind of small thing that decides whether a launcher gets used.

A phone on a glass shelf in front of a dark television, screen showing a soft grid.

There are 114 Apple TV aerial films as screensavers, in 4K or Dolby Vision where the panel supports it, plus Bing's daily image, fourteen built-in wallpapers, and photos pushed from a phone. Rows can hold four, five, or six apps, single or double height, with adjustable clock size and position, focus style, and key sounds. Fixed HDMI inputs can be labelled with the right icon for an Apple TV, a PlayStation, a Switch, an Xbox, or a PC.

The README is written for an assistant

The thing that connects these two projects, and probably the reason both went viral, is that neither asks you to read a manual.

cleanyourtv tells you to clone the repo and paste a prompt into your coding assistant. aerial-tv ships a downloadable APK and a QR code. Both route around the two things that kill home-lab projects: a toolchain and a command line.

That is a real distribution shift, and it is not limited to televisions. A README that says "paste this file into Claude Code and answer its questions" is now a legitimate installation method, and it reaches an audience that would never have compiled a JDK project. Most of those 57,000 stars belong to people who read the first paragraph, understood that the barrier was gone, and starred it as a bookmark. Few of them ran it.

What can go wrong

Both tools warn about the same risk, and it deserves repeating. Disabling a system package on a television can leave it unable to boot into anything, and while pm disable-user is reversible in principle, reversing it requires getting a shell back onto a device that may no longer be listening.

The mitigations are in the repositories: back up first, keep the restore script, and do not disable packages you cannot identify. aerial-tv avoids the whole category by not touching system packages at all, which is why it is the safer of the two for someone who is not comfortable with ADB.

The other caveat is regional. Both projects are built around the Chinese smart TV experience, where the ad load is severe enough to motivate this much work. On a Google TV device sold in the US or Europe the same tools will run, but many of the packages they target will not exist, and the improvement will be smaller.

Which one to pick

If the hardware is good and the software is the only problem, and you want the manufacturer's apps to keep working, disable the bloat and keep the original launcher underneath. That is cleanyourtv, and the restore path is the reason to prefer it.

If you want a home screen that behaves like a piece of consumer electronics rather than a billboard, and you are willing to lose the vendor's content rows permanently, install the launcher. That is aerial-tv, and the phone-based organization alone justifies it.

Doing both is also reasonable, and probably what most people end up with: disable the ad services, then replace the thing that was showing them.

The broader point is that a television is a computer, and the same thing that happened to phones, where the vendor's interface is a suggestion rather than a fact, is finally happening to the living room. It took a 57,000-star Python script and a Kotlin launcher, both free, both reversible, to make the point.

Related articles