Debloat an Android TV over ADB and install a clean launcher

Gathin23 had Claude Code connect to a Google TV over ADB, disable the ad-laden stock apps and build and install a minimal tvOS-style home screen in an afternoon.

Done withClaude Code· Oct 17, 2026

What they did

Gathin23 was tired of sponsored tiles on their Android TV home screen. With USB debugging switched on in the TV's developer options, they gave Claude Code a prompt that has it talk to the set over network ADB, back up the package list, ask the owner which apps they actually use, disable the rest, then build a small native launcher with a four-app dock and install it on the TV. The agent checked each step by pulling screenshots from the TV. Because the stock adb binary was blocked on their Mac, the project ended up with a small Python ADB client and a chunked uploader for APKs. They published the prompt, the launcher, the tools and a per-model debloat list as an MIT repo.

How it went

The author says the whole thing was built in an afternoon and shows the stock Google TV home with an ad next to the new black launcher. It was tested on a Xiaomi Mi TV 4A, and other models are invited as contributions. Along the way they hit several traps: chained pm commands stopping after the first, large pushes hanging, and the on-screen keyboard vanishing after the launcher swap until the input method was reset. The repo picked up 43 stars on its first day. There are no reports yet from other TVs.

Worth knowing

Packages are disabled, not uninstalled, and a restore script brings the stock launcher back, so it can be undone. Disable the stock launcher only after the new one is installed, or the Home button lands on a factory test app. Building the launcher needs JDK 17 and the Android SDK. It does not work on Samsung Tizen, LG webOS or Fire TV.

Try it

With Claude Code· 3 parts to fill in

Connect to my Android TV, a [TV model], at [TV IP address] over ADB (USB debugging is on; tell me when to accept the prompt on screen). First save a full list of installed packages and the current launcher so everything can be restored. Then show me the preinstalled apps grouped as ads, bloat and needed, and ask which ones I use and which [number] go in the dock. Disable, never uninstall, only the ones I approve, one command per call. Build and install a minimal launcher with my dock, and only after it works disable the stock one. Take a screenshot from the TV after each step and stop if anything looks wrong.

Square brackets are the parts to fill in. The prompt is ours; the story is theirs.

Where they said it

Related