cleanyourtv README

项目的 README,来自 github.com/Gathin23/cleanyourtv。合并为一个 markdown 文件:README.md。

CleanYourTV. Your TV, minus the ads. Strip the bloatware from any Android TV or Google TV over Wi-Fi and replace the ad-filled home screen with a clean launcher that looks like an Apple TV. No root, no cable, nothing uninstalled, and a one-line restore.

Read in: עברית · 简体中文 · 正體中文 · Tiếng Việt · 日本語 · Italiano · Português · Nederlands · Deutsch · Українська · Türkçe · Oʻzbekcha · Français · Español · Ελληνικά

Stars Merged PRs Forks Contributors Support, buy me a coffee CleanYourTV on Product Hunt

488 TV models · 132 brands · 31 languages · 572 KB launcher. Featured in TechCrunch, TechRadar, Tom's Guide, Mashable, Android Authority, XDA, FlatpanelsHD, It's FOSS, Phandroid, GIGAZINE, Xataka, WinFuture, Frandroid, Macitynet, Techaeris, TechPP and 530 more: 546 articles from 57 countries. Before: stock Google TV home with a sponsored ad. After: the Clean Your TV launcher. #1 trending repo of the week, Oct 19–25 2026, via trendshift.io.

Start here

You have Go to
An Android TV or Google TV Quick start: a coding assistant does the work in about fifteen minutes.
A Samsung, LG, Roku, Vizio or Hisense VIDAA TV cleanyour.tv/not-android: CleanYourTV can't run there, but you can turn off the tracking with your remote.
A phone or laptop, no coding agent One of the community apps for Android phones, Mac and Windows, made by independent developers.
Want to see it first What you get: screenshots of the new home screen.

Official links: cleanyour.tv and this repo. Other domains using the name, such as cleanyourtv.com, are not run by this project (#1004). CleanYourTV publishes no app in any app store, and clean-your-tv.net is not ours either.

How it works · Quick start · What you get · Supported TVs · Doing it by hand · The launcher · Restoring · Firmware updates · Questions · Contributing

How it works

Android TVs have the same debug bridge as Android phones. Switch on USB debugging in the TV's developer options, allow your computer once, and the rest is standard Android tooling:

Step What happens
Back up The list of installed packages and settings.
Disable The manufacturer's telemetry, ad services, content rows and preloaded junk, with pm disable-user. Nothing is uninstalled, so a restore script can undo every step.
Install A small native launcher, made the default home screen.

No root, no cable, nothing uninstalled, and a one-line restore if you change your mind.

The bloat differs by brand, so the prompt has your coding assistant discover it on your TV and ask before touching anything you might use.

Quick start

You have Do this
A computer Use the prompt with a coding assistant: the three steps below.
A computer, no coding assistant Run the three steps yourself: the commands are in Doing it by hand.
A phone or laptop, no coding assistant Pick one of the community apps: free, open-source apps built on these TV lists by independent developers.

The three steps below are written for a coding assistant: the computer needs to be on the same Wi-Fi as the TV, with a shell on it, plus Python 3, a JDK from 17 through 22, and Android SDK platform 34 with build-tools 34 (the assistant builds the launcher there). Without an assistant, Doing it by hand is the same job, run by you, and it has the install commands.

Any of these work: Claude Code (on 0G Private Computer or an Anthropic plan), Codex, Gemini CLI, Antigravity CLI or DeepSeek Harness.

Where What to do
1. On the TV Settings → Device Preferences → About → press OK on Build seven times → back → Developer options → USB debugging on. If you see a Network or ADB debugging toggle, turn that on too. Keep the TV on.
2. On your computer Clone the repo and open that folder in your assistant (git clone https://github.com/Gathin23/cleanyourtv), then paste PROMPT.md and fill in your TV model.
3. Follow along Accept "Allow USB debugging?" on the TV, then answer the checklist: which apps you use, the dock size and app order, whether to keep the voice assistant, Chromecast and updates.

Cloning matters: the assistant reuses this repo's tools/disable.sh and launcher/build-and-install.sh instead of writing its own, and that is where the backup, the Home guard and the restore record live.

The assistant backs up, debloats, builds and installs the launcher, and checks each step with screenshots pulled from the TV. With this repo as context it takes about fifteen minutes.

What you get

A home screen that looks like an Apple TV and gets out of the way:

Part What it looks like
A pitch-black home A dock of your four favourite apps in a rounded band, where Apple TV puts it.
A top shelf Names the focused app in large type, with an ambient glow in a colour taken from its artwork.
The rest of your apps in a grid Slides up when you press Down.
One floating glass highlight Springs from tile to tile. The focused tile lifts and shows its name.
Three frosted buttons Inputs (HDMI ports under the names you gave them in the TV's settings, AV, Live TV), Wi-Fi or Ethernet with the network name, Settings.
A greeting, a thin clock and the date In Outfit, and a matching Clock screensaver. Set show_stats in config or a theme for one line under the clock: CPU, free memory and free storage. It stays off unless you turn it on, and it refreshes only while Home is on screen.
Themes and module cards Themes change colours, wallpaper, dock and columns without a rebuild, and module cards let other apps plug a tile in, only with your say-so.

And a TV that stops working against you: no sponsored rows, no "Discover" nags, no analytics phoning home, no apps you never asked for.

The top shelf names the focused app over an ambient glow in its colour The Inputs popup: HDMI ports with what is connected, AV and Live TV
Top shelf and ambient glow Inputs: HDMI with connection state, AV, Live TV
The grid with the glass highlight on a tile and its name beneath The Clock screensaver: a thin clock drifting over the glow
The grid, one glass highlight, the tile's name Clock screensaver, drifts so nothing burns in
The aurora theme: a wallpaper and tinted pills, pushed without a rebuild Six columns and a six-app dock from a theme's config.json
Aurora theme, pushed with tools/theme.sh Six columns and a six-app dock, same launcher
Moving a tile: held OK, chose Move, the tile is picked up and the others dim The App library: installed apps, one press adds an app back to Home
Hold OK on a tile, Move: arrows carry it, Back puts it down App library: one press puts a removed app back on Home

Supported TVs

Anything running Android TV or Google TV.

Platform What works
Android TV, Google TV The debloat and the launcher.
Fire TV The debloat half only, since Fire OS will not hand Home to a third-party launcher. And on the 2015 Fire TV Box (Fire OS 5) even that half fails: every pm route is refused.
A few China-market TCL sets They refuse to install any launcher at all; their lists say so in the header.
Samsung (Tizen), LG (webOS), Roku, Vizio, Hisense VIDAA Not supported (no ADB). Turn off the tracking instead: cleanyour.tv/not-android. See SHOWCASE.md for four webOS ports, and docs/devices/samsung-tizen.md for what a 2021 Samsung set answers over Wi-Fi (no ADB, so no pm disable-user) if you are weighing a Tizen port. For an LG webOS 26 set, docs/devices/lg-webos.md covers the settings and DNS filtering with a firewall rule against other resolvers.

Tested lists from contributors, one folder per model in examples/. The brands with the most lists, each linked to its models on the website:

TCL · 88 Sony · 53 Xiaomi · 46 Philips · 24 Hisense · 17 Skyworth · 17
SHARP · 11 Amazon Fire TV · 9 Panasonic · 8 Haier · 7 BenQ · 6 JVC · 6
Toshiba · 6 Acer · 4 Formovie · 4 Nokia · 4 OnePlus · 4 Thomson · 4
Artel · 3 CHiQ · 3 FFalcon · 3 Google · 3 Grundig · 3 Master-G · 3
Motorola · 3 Noblex · 3 NVIDIA Shield · 3 onn · 3 RCA · 3 Redmi · 3
+87 more brands and 15 projector brands

RockTek 3 · Vu 3 · Challenger 2 · DEXP 2 · EKO 2 · Hitachi 2 · Insignia Fire TV 2 · Kalley 2 · Kogan 2 · Lumio 2 · PRISM+ 2 · Sankey 2 · Sber 2 · Síragon 2 · TIM 2 · Vidda 2 · AiPro2K · AiPro4K · AIWA · AQUA · ASUS · Beko · Bell Canada · BGH · BTV · Caxium · Cecotec · Compac · Continental Edison · Daewoo · Dcolor · Dialog · Durabrand · DYON · ENGY · Essentiel b · Freebox · HAAM · Hikeen · Home+ · Impex · INCLO · Indurama · Jio · Karbonn · Kodak · Koryo · KTC · KUNFT · Liberton · LYNCAST · Magyar Telekom · MarQ · MECOOL · Metz · MTC · Next · OK. · OPPO · Panavox · PEAQ · Philco · Polytron · PPTV · Prosonic · realme · Salora · SAMPO · SANYO · Seleco · Smarttech · STRONG · SunWind · Super General · TD Systems · Tele System · Tesla · TiVo · Tornado · Turbo-X · Turkcell · Tuvio · Verizon · VISIO · Vision · Vityas · X.Vision · Alwtniet, Anker Nebula, BYINTEK, Chihi, Epson, Gadnic, HOTACK, HY320, JMGO, Magcubic, Nonete, Portronics, Stellamore, Wanbo and XGIMI projectors

Find your TV: search cleanyour.tv/tvs or the full table in examples/README.md.

Your TV not here? The prompt discovers the bloat itself. Add your list afterwards and the next person with your model skips that step: CONTRIBUTING.md.

Doing it by hand

Everything the assistant does, you can run yourself. Two things have to be on the computer first:

You need For
Python 3 (any 3.x) The tools. The venv command below installs what they import.
JDK 17 through 22 (a full JDK, including jlink) and Android SDK platform 34 with build-tools 34.0.0 or any newer 34.x Building the launcher. JDK 23 and newer stops Gradle 8.9. Platform 34 is the one the build reads; a newer platform does not replace it. On macOS, when none of these is installed: brew install openjdk@17 android-commandlinetools, then sdkmanager "platforms;android-34" "build-tools;34.0.0". On Linux the install script looks in ~/Android/Sdk and for java on your PATH.

tools/tv.py talks to network ADB on port 5555. If that port stays closed and the TV offers Wireless debugging with a pairing code (the Chromecast with Google TV and the Google TV Streamer do), pair it once with the stock adb. Then either run adb tcpip 5555 to open the port, which usually lasts only until the TV reboots, or keep it closed: point TV_ADB_BINARY at that same adb and TV_HOST at the port the Wireless debugging screen shows, and the tools reach the TV through the paired connection with nothing listening on 5555 (tools/native-adb.md). Troubleshooting has both, with the pairing steps.

python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50                                   # your TV's IP address

tools/venv/bin/python -I tools/tv.py --probe                 # model, Android version, firmware
tools/venv/bin/python -I tools/tv.py 'pm list packages'      # one shell command on the TV
tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt        # apply a debloat list
tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt        # undo it, stock launcher back
tools/venv/bin/python -I tools/check.py examples/xiaomi-mi-tv-4a/debloat.txt   # what a firmware update undid
launcher/build-and-install.sh                                # build the launcher and make it Home (needs the TV_HOST export above)
tools/theme.sh themes/aurora                                 # push a theme; --reset removes it
tools/venv/bin/python -I tools/wallpaper_prep.py ~/Pictures/trip mytheme/wallpapers   # your photos, sized and darkened for the TV
Tool What it does
tools/tv.py Pure-Python ADB client: shell, batch, push, pull, reboot, and screenshots, optionally pressing remote keys first. Works where the stock adb binary is blocked. Optional paired Google ADB backend for encrypted Wireless debugging.
tools/docker-build.sh Builds the launcher or an add-on in Docker (JDK 17, Android SDK 34), so this computer needs nothing but Docker. Install the result with SKIP_BUILD=1. Guide.
tools/b64push.py Uploads large files such as APKs in base64 chunks and verifies the checksum.
tools/relay.py Forwards a local port to the TV's ADB port, for assistants whose sandbox can't reach your network. Listens on this computer only. Guide.
tools/disable.sh, restore.sh Apply or undo a debloat list, the undo from the state recorded before the change.
tools/recovery.py Writes the record disable.sh needs to undo itself, and prints the restore batch.
tools/check.py Compares the TV with the list that was applied, for what a firmware update undid; --fix puts it back.
tools/match.py Reads a saved pm list packages and prints, for each package, how many lists in examples/ disable it, how many keep it commented out, and their most common note; Android's core packages show as never. Offline, changes nothing (tools/venv/bin/python -I tools/match.py packages.txt).
tools/adb-closed.py Checks that the TV's network ADB port is closed once debugging is off: exits 0 when the TV refuses the connection, 1 while it is still open, 2 when nothing answered or the check itself could not run. No nc needed.
tools/philips-api.py Philips only: checks that the JointSpace control API Home Assistant uses still answers, before and after a debloat (tools/venv/bin/python -I tools/philips-api.py <tv ip>). Port 1926 over HTTPS first, then 1925; reads only what answers without pairing.
tools/privacy.py Audits the TV for voice, ACR and telemetry candidates and prints the evidence for each; --write turns the findings into a list disable.sh and restore.sh already understand.
tools/theme.sh, theme_restart.py Push a folder from themes/ to the launcher and restart Home.
tools/wallpaper_prep.py Turns a folder of your own photos (JPEG, PNG, WebP, HEIC) into darkened 1280×720 JPEGs under 300 KB for a theme's wallpapers/ folder. Needs Pillow, plus pillow-heif for HEIC (tools/requirements-photos.txt). Never touches the originals. How to use it.
tools/manage.py List every add-on, theme and switch with its screenshot, see what is on the TV, and install, update or remove one by running its creator's own script.
tools/bench.py Measures the launcher that answers HOME: key latency, how far the focus moved, janky frames, cold start, return to Home, and the idle CPU and PSS it costs. Changes nothing on the TV and writes the raw per-key numbers to JSON; no extra install.
tools/trace.py, trace_report.py Records Perfetto traces of the launcher (return to Home, cold start, D-pad) and reports where its time goes, per run and before against after. Optional: needs requirements-perf.txt. Guide.
tools/flamechart.py Draws a before/after flame chart from those traces, for a pull request: one lane per thread on a shared time scale, the work a change targets in magenta with its total. Optional, like the trace tools. Guide.
tools/screendiff.py Compares a before and an after screenshot pixel by pixel, leaving out the clock or anything you mask, and writes the pair with your Wi-Fi name blurred. Optional, like the trace tools. Guide.
tools/race_calendar.py Writes this season's F1 calendar into a theme for race-weekend mode, from the free Jolpica API.
launcher/build-and-install.sh Builds a shrunk release (about 572 KB), installs it, switches Home, and rolls back if Home does not land on it.

The scripts never leave the TV without a Home app: they only disable a stock launcher they recognise, and skip the Home app in a list until another launcher answers HOME. Your own lists can live outside the repository: list paths are relative to the directory you run from, and absolute paths work too.

Windows (PowerShell)

Every script has a PowerShell twin next to it. Install Python 3 and a JDK from 17 through 22, and in the SDK Manager add platform 34 and build-tools 34 (34.0.0 or any newer 34.x). The script uses JAVA_HOME when it points at a JDK in that range, and otherwise Android Studio's bundled JDK when that JDK is in the same range:

python -m venv tools\venv; tools\venv\Scripts\python.exe -m pip install -r tools\requirements.txt
powershell -ExecutionPolicy Bypass -File launcher\build-and-install.ps1 -TvHost 192.168.1.50
powershell -ExecutionPolicy Bypass -File tools\disable.ps1 -TvHost 192.168.1.50 examples\xiaomi-mi-tv-4a\debloat.txt
powershell -ExecutionPolicy Bypass -File tools\restore.ps1 -TvHost 192.168.1.50 examples\xiaomi-mi-tv-4a\debloat.txt
powershell -ExecutionPolicy Bypass -File tools\theme.ps1 -TvHost 192.168.1.50 themes\aurora

The last two are the undo and a theme push, the tools/restore.sh and tools/theme.sh lines the sections above give in bash. On Google TV the undo takes the stock launcher as well: -Stock com.google.android.apps.tv.launcherx.

How the scripts protect Home

The install scripts ask the TV which launcher owns Home and only disable one they recognise, the four in KNOWN_STOCK_LAUNCHERS: com.google.android.tvlauncher, com.google.android.apps.tv.launcherx, com.google.android.leanbacklauncher and Xiaomi's com.mitv.tvhome (PatchWall). Pass STOCK_LAUNCHER=<package> (-StockLauncher) to override, or none to leave it alone.

tools/disable.sh (disable.ps1) applies the same rule before it disables anything:

  • If the list contains the app that owns Home and no other app on the TV answers HOME, it skips that entry, says why, and disables the rest of the list. So a list applied before the launcher handover cannot leave the TV with nothing to start.
  • The setup wizard, the settings apps, a vendor FallbackHome and factory-test apps (Xiaomi's com.duokan.factorytest) answer HOME too and don't count.
  • On Google TV it also keeps the owner while setupwraith answers HOME and stays enabled (not listed, or kept for the Wi-Fi network): setupwraith answers ahead of an installed launcher that is not Home yet, so it would take Home.

Run the same list again once launcher/build-and-install.sh has made the new launcher Home and the entry is applied; FORCE_HOME=1 ($env:FORCE_HOME) disables it anyway.

The microphone, and what can be said about it

"Which of these packages is listening?" has no honest one-line answer: a permission scan shows fifty system packages with RECORD_AUDIO that record nothing, and ACR clients see the screen with no audio permission at all. tools/privacy.py reports what the TV actually says, with the evidence for each voice, ACR and telemetry candidate: TV_HOST=192.168.1.50 tools/venv/bin/python -I tools/privacy.py, and --write turns them into a normal debloat list. What the audit cannot do is prove intent: docs/privacy.md explains why.

The launcher

A small native home screen for Android TV: about 572 KB, plain Java, built for TVs with 1 GB of RAM. No blur, no video, no network permission, no background services. The TV needs Android 8.0 (API 26) or newer, the minSdk in launcher/app/build.gradle; what is left on an older set is in Troubleshooting.

What How it works
Configure Dock order, hidden apps, Live TV app, 4 to 7 tiles per row, reduced motion. All in config.xml
Settings on the TV Hold OK on Settings for launcher settings. Optional launcher_settings_button makes a normal click open them directly; TV settings remain on the settings page and their app tile.
Themes Background, wallpaper and layout from a config.json pushed over Wi-Fi, no rebuild. Thirty-one ship in themes/, the built-in default/ included
31 languages Follows the TV's language, with a fully mirrored right-to-left layout for Hebrew
App library Optional: browse every installed app and add or remove Home shortcuts. See the app library guide
Tile menu On by default (tile_menu): hold OK on a tile for Move and App info, plus Remove from Home when the app library is on. Off, holding OK opens App info
Module cards Any TV app can offer its own tile; you approve each one once. See docs/modules.md
Add-ons Optional apps that plug in as module cards, kept in addons/ and never built into the launcher
Clock screensaver A drifting clock over the glow, so nothing burns in
Remote keys Keeps the Input, YouTube and gear buttons working after the stock launcher is gone

Themes, switches and add-ons together, with screenshots: cleanyour.tv/addons.

More: docs/launcher.md has the launcher settings page row by row, changing the default home, the languages, remote keys, the Clock screensaver, navigation and building it yourself.

Your own photos as the background

A theme can rotate a folder of pictures behind Home, with no rebuild. No pictures ship with the repo: you bring your own, and you decide you have the right to show them.

  1. Start a theme folder. Copy a theme you like from the themes folder, for example themes/aurora, into a new folder such as mytheme/, or start with an empty config.json.

  2. Prepare the photos. A bright 12 MP photo is heavy for a 1 to 2 GB TV and drowns the clock and tiles. tools/wallpaper_prep.py centre-crops to 16:9, saves 1280×720 JPEGs under 300 KB, and darkens the picture itself, so wallpaper_dim can stay at 0. HEIC phone photos work. Your originals are never touched. Pillow goes into the tools/venv the quick start creates, not into a system Python, which has neither the package nor (on Ubuntu) a pip that may install it.

    tools/venv/bin/pip install -r tools/requirements-photos.txt
    tools/venv/bin/python -I tools/wallpaper_prep.py ~/Pictures/trip mytheme/wallpapers
    

    Options: --brightness 0.25 (0.1 to 1.0), --gradient 0.6 (extra black toward the dock), --size 1280x720, --max-kb 300.

  3. Set the rotation in mytheme/config.json:

    { "wallpaper": true, "wallpaper_rotation_minutes": 1, "wallpaper_order": "shuffle", "wallpaper_dim": 0 }
    
    Key Notes
    wallpaper_rotation_minutes Whole minutes, 0 to 1440. 1 is the fastest. 0 means no rotation, and a fraction such as 0.25 is read as 0, which stops it.
    wallpaper_order shuffle never shows the same picture twice in a row; sequential follows the file names.
    wallpaper_dim Black overlay in percent. Leave at 0 when the pictures are already darkened.
    dock_glass, dock_opacity A frosted-glass dock band (30 to 100%) so the picture shows behind the tiles.
    greeting_name A name after the greeting: "Good evening, Sam".
    show_stats, app_library, reduced_motion A stats line under the clock, an App library pill, calmer motion for weak GPUs.
  4. Push it to the TV (this restarts Home once, and keeps the Home-key helper working):

    tools/theme.sh mytheme            # Windows: tools\theme.ps1 -TvHost 192.168.1.50 mytheme
    

    On the TV, Launcher settings → Wallpaper holds one picture, None, or Theme default, which rotates again.

  5. Take it off with tools/theme.sh --reset.

What it cannot do: there is no crossfade (the picture changes with a cut), no rotation faster than a minute, and the Clock screensaver shows time and date only, never photos. Without a wallpapers/ folder the theme still works and Home keeps its plain colour. A picture is decoded into memory while Home shows it: about 4 MB at 1080p in the default 16-bit colour, 8 MB with wallpaper_true_color (see themes/README.md), so keep the pictures small on a 1 GB TV.

Restoring your TV

Keep the list you applied. One line puts the TV back the way it was:

TV_HOST=192.168.1.50 tools/restore.sh examples/<your tv>/debloat.txt                                    # Android TV
TV_HOST=192.168.1.50 tools/restore.sh examples/<your tv>/debloat.txt com.google.android.apps.tv.launcherx  # Google TV
What How
A record comes first Before tools/disable.sh changes anything it writes down what the TV looked like, in ~/.cleanyourtv/.
Restore replays it A package you had disabled yourself stays disabled, and Home goes back to the component that owned it.
The launcher stays installed Remove it from the TV's Settings → Apps if you want it gone.
No computer? If the TV is unreachable, its own Settings → Apps page can re-enable packages too.

More: docs/restore.md has what the record holds, when the stock launcher argument counts, and what happens without a record.

After a firmware update

An update installs over the cleaned-up system: the listed packages come back, Home goes to the stock launcher, and new preloads appear that no list mentions. Open ADB again as in Quick start step 1, then compare the TV with the list you applied; --fix puts it back:

TV_HOST=192.168.1.50 tools/venv/bin/python -I tools/check.py examples/<your tv>/debloat.txt

More: docs/firmware-updates.md has the exit codes, a weekly check, what --fix changes, TVs that keep the stock launcher as Home, and lists that disable the updater.

When something goes wrong

The full list of things that bit us is in docs/TROUBLESHOOTING.md. The three that matter most:

Questions people ask

I don't code and don't have a laptop. Can I still do this?

Yes. Independent developers have built free, open-source apps on CleanYourTV's TV lists that do the cleanup over Wi-Fi, with no coding agent. Each shows a plan first, only switches apps off, and can put everything back:

App For By
Clean Your TV app Android phone @udhaykumarbala
Tellyscope Android phone @man15h
TidyTV Android phone, Google Play @jolan94
CleanMyTV Mac and Windows @wingedpanther

These apps are independent projects, not affiliated with or endorsed by CleanYourTV or its maintainer, and each is provided as is under its own license. Report app problems in that app's repo. More at cleanyour.tv/app.

Is this safe? Can it brick the TV?

Nothing is flashed, rooted or deleted; packages are disabled in the user profile. The risk is disabling something the TV leans on, which is why lists are applied in small batches with a restore script ready. The TV's own Settings → Apps page can re-enable packages even without the tools. If the TV no longer starts far enough for that, a factory reset from its recovery menu is usually the way back.

More: docs/faq.md

What about firmware updates?

The updater is left on in most lists, so firmware updates arrive as usual. Some lists disable the TV's own updater, and on those a firmware update arrives only when you re-enable it. When one does land it installs over the cleaned-up system, so a package comes back and you re-run the script: see After a firmware update.

Won't the apps break?

Streaming apps still update through the Play Store, which is left alone. The launcher just lists what is installed and launches it with intents that have been stable for a decade.

How do I rearrange my apps?

Hold OK on Settings (top right) and choose Reorder apps. OK picks an app up, the arrows move it, Back places it, and Back again finishes. Holding OK on a tile also offers Move (tile_menu, on by default), which picks that app up straight away. More: docs/launcher.md

Can I do this for someone in another home?

Yes, over a private Tailscale link instead of the same Wi-Fi: either Tailscale on their TV, shared with you, or a computer or Apple TV at their home routing to it. Never by opening the ADB port on their router. Step by step in docs/REMOTE.md.

Isn't ADB access a security hole?

It is one explicit "allow this computer" tap on the TV, the same as developing an Android app. Network ADB is plaintext on port 5555, and on some firmware any device on the LAN gets a shell, so close it when you are done:

  1. On the TV: Developer options → turn USB debugging, Network/ADB debugging and Wireless debugging off, whichever the TV has, and revoke the USB debugging authorisations.
  2. Reboot the TV, then confirm the port is gone from your computer: python3 tools/adb-closed.py <tv ip> must say the port is closed.

The launcher keeps working without debugging. More, including checking Wireless debugging's own port: docs/faq.md

Can it block ads inside apps too?

Partly, with Android's Private DNS (Android 9 and newer). Point it at an ad-blocking resolver such as AdGuard DNS and every app's ad and tracker domains stop resolving, system-wide, surviving reboots. The trade-off: that resolver then sees every DNS query the TV makes, and it does not remove YouTube ads.

More, with the two commands and how to switch back: docs/faq.md

Are there switches in the TV's own Settings worth flipping too?

A few, and they need no ADB: the advertising ID, Location, Usage & diagnostics and Scanning always available, plus Apps only mode where the stock launcher stays. Flip Usage & diagnostics before the debloat; on some TVs its page goes with it.

More, with the paths for Google TV, Android TV and Fire OS: docs/faq.md

AirPlay?

Not from this repo. Chromecast built-in stays for Android phones. For iPhones, jqssun/android-airplay-server works; an install script for it is in PR #84.

Can I just download the APK?

Build it with the one-line script in Doing it by hand; it takes a minute and you control what goes on your TV. That needs the JDK and Android SDK named there. No prebuilt binaries.

The story

On 17 October 2026 I posted a before and after of my parents' TV, cleaned up by Claude Code over Wi-Fi. It reached 8.6M views, people started doing the same to their own TVs, and their replies turned into the lists here: 170+ TV models from 200+ contributors in the first four days. The repo was called tv-vibehack until the 19th; old links work.

Two weeks on, it was the #1 trending repository on GitHub for the week of 19–25 October, with over 46K stars and 5.7K forks, and 1.4M views and 260K clones in 14 days. By 14 November it had 57K stars and 7.4K forks. The lists now cover 488 TV models from 132 brands. The coverage: 546 articles from 57 countries and 674 videos on YouTube and Bilibili, all in docs/PRESS.md (numbers as of 14 November 2026).

Contributing

The most useful contribution is your TV's debloat list, so the next person with that model does not have to rediscover it. CONTRIBUTING.md has the format and the testing we ask for. Contributing through a coding agent? AGENTS.md gives it the same rules.

How to help What it means
Your TV's debloat list The most useful one: the next person with that model skips the discovery.
Launcher and prompt Launcher improvements and sharper prompt wording are welcome too.
Built something on top? A launcher, a port, a theme: add it to SHOWCASE.md, where two hundred and sixty projects already live, sorted into home screens, forks, add-ons, tools and other platforms, with an index by TV brand.

The people whose work is in this repo:

Contributors

Star history

Star history chart

Contact

For Where
Questions about your TV GitHub Discussions
Press and queries [email protected]
Security issues Report them privately through the Security tab, see SECURITY.md

Licence

MIT, see LICENSE. The Outfit typeface is under the SIL Open Font License, see launcher/FONT-LICENSE-OFL.txt.

cleanyourtv (Gathin23/cleanyourtv)

正在搜索数据库…

这是什么?一套工具,可以通过 Wi-Fi(借助 ADB)精简任何 Android TV 或 Google TV 上的预装冗余应用并去除广告,然后把原厂主屏幕换成干净的仿 Apple TV 风格启动器。
这是我要安装的应用,还是一组脚本和工具?两者都是:一组 Python、shell 和 PowerShell 脚本,通过 ADB 精简电视;另外还有一个小型原生 Java Android TV 启动器应用,需要你自己编译和安装。
我到底怎么在电视上运行它?在电视上开启 USB 调试(设置 → 关于 → 连续点击版本号 7 次 → 开发者选项),然后打开 Claude Code 之类的编程助手,粘贴 PROMPT.md 中的提示词,填写你的电视型号,并按照屏幕上的清单操作,它会依次完成备份、精简、编译和安装启动器。
我需要 Claude Code 吗,还是还需要其他工具?你需要一台与电视连接同一 Wi-Fi 的电脑,以及任意一个具备 shell 访问权限的编程助手(Claude Code 或类似工具);Python ADB 工具只需要 Python 3,编译启动器则需要 JDK 17 和 Android SDK platform 34。
这个能用在所有品牌的电视上吗?仅支持 Android TV / Google TV 设备(小米、TCL、海信、索尼、一加、Realme、Nvidia Shield 等);三星 Tizen、LG webOS 和亚马逊 Fire TV 运行的是不同的系统,无法通过这种方式精简或更换启动器。
我需要在电视上获取 root 权限吗?不需要 root。所有操作都通过标准的 Android 调试桥完成,你只需在电视上批准一次“允许此电脑”的提示即可。
我可以在 Windows 上运行安装吗,还是只能用 macOS/Linux?可以。Windows 有 PowerShell 脚本(无需 WSL 或 Git Bash),macOS/Linux 则使用 .sh 脚本;安装脚本会自动检测 Android Studio 自带的 JDK 和 SDK。
启动器需要联网才能用吗?启动器本身不做任何联网操作——没有模糊背景、视频或后台服务,只是列出并启动电视上已安装的应用。
这样安全吗?会不会把电视弄坏?不会。不会刷机、获取 root 或删除任何东西;应用只会通过 pm disable-user 对当前用户禁用,固件保持不变,还原脚本(或电视自带的设置)可以重新启用所有应用。
我能直接下载现成的启动器 APK,而不自己编译吗?不能。项目不提供预编译的二进制文件;你需要用一行 gradle 命令自己编译启动器,大约需要一分钟。
换了启动器后,视频类应用会坏掉吗?不会。视频应用会照常通过 Play 商店更新;启动器只是列出已安装的应用,并通过稳定的 Android Intent 启动它们,不会直接与应用交互。
新启动器到底长什么样?纯黑色的主屏幕,底部有一排四个应用的快捷栏,顶部一条显示当前焦点应用名称的栏,并带有来自其海报图的环境光色彩光晕;另有可滑动的应用网格、磨砂质感的“输入”“Wi-Fi”“设置”按钮,以及可选的漂浮式时钟屏保。
精简之后,固件更新会怎样?大多数精简列表都会禁用厂商的更新服务,所以只有你手动重新启用它,更新才会到达;如果某次更新重新启用了某个包,只需重新运行一次精简脚本即可。
作者
Gathin23
大小
94.7 MB
星标
59K
时长
1个月
提交 · 90 天