cleanyourtv
by Gathin23
Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.
3,402stars
401forks
Java
Added 10/19/2026
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
AI Agentsad-freeadbandroid-tvandroid-tv-launcherbloatware-removalclaude-codedebloatgoogle-tvhisensehome-screenlaunchernvidia-shieldopen-sourcesmart-tvsony-braviatclxiaomi
Maintainer of this skill?
Installation
# Add to your Claude Code skills
git clone https://github.com/Gathin23/cleanyourtvGetting Started
Guides for using ai agents skills like cleanyourtv.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Compare with similar skills
See how cleanyourtv compares with popular alternatives.
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 if you change your mind.
Vibe coded my parents' TV this afternoon! It was showing a sponsored ad before you could even get to Netflix. Gave Claude Code the model number, it found the TV on wifi, removed 25 Xiaomi packages and wrote a new launcher. Looks like an Apple TV now lol.
@gathint, 17 October 2026. The replies are where most of the TV lists here came from. The repo was called tv-vibehack until the 19th; old links work.
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:
- 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 and make it the default home screen.
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 need a computer on the same Wi-Fi as the TV and a coding assistant with shell access (Claude Code or similar).
| 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 | Paste PROMPT.md into your assistant and fill in your TV model. |
| 3. Follow along | Accept "Allow USB debugging?" on the TV, then answer the checklist: which apps you use, which four go in the dock, whether to keep the voice assistant, Chromecast and updates. |
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 pitch-black home with a dock of your four favourite apps in a rounded band, where Apple TV puts it.
- A top shelf naming 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 that slides up when you press Down.
- One floating glass highlight that springs from tile to tile. The focused tile lifts and shows its name.
- Three frosted buttons: Inputs (HDMI ports, 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.
- Themes that change colours, wallpaper, dock and columns without a rebuild, and module cards that 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.
Supported TVs
Anything running Android TV or Google TV. Samsung (Tizen) and LG (webOS) run different systems; see SHOWCASE.md for a webOS port. Fire TV takes the debloat half only, since Fire OS will not hand Home to a third-party launcher. A few China-market TCL sets refuse to install any launcher at all; their lists say so in the header.
Tested lists from contributors, one folder per model in examples/:
Xiaomi 8 · TCL 7 · Sony 2 · BenQ · CHiQ · Chromecast with Google TV · Hisense · Insignia Fire TV · NVIDIA Shield · OnePlus · Philips · RCA · SANYO · Toshiba Fire TV · Stellamore and XGIMI projectors
| TV | OS |
|---|---|
| BenQ E55-735 (Changhong AI PONT, DVB96BQ) | Google TV 14 |
| CHiQ AI PONT (DVB93CQ) | Android TV 11 |
| Chromecast with Google TV 4K (sabrina) | Google TV 14 |
| Hisense SmartTV 4K FFM (huangshan, MediaTek) | Android TV 10 |
| Insignia 55" F30 4K Fire TV (NS-55F301NA25, AFTDCT31, duckie) | Fire OS 7 / Android 9 |
| NVIDIA SHIELD TV Pro 2019 (P2897, mdarcy) | Android TV 11 |
| OnePlus TV (D00, Dubai) | Google TV 14 |
| Philips Smart 4K TV (Skyworth, eleonas, MediaTek), India | Google TV 14 |
| RCA AI PONT SA (Changhong, redwood, ISDB92RC; also sold as realme 40-inch) | Android 14 |
| SANYO ATV R2 (SCBC, Realtek RTD285O) | Android TV 9 |
| Sony BRAVIA 4K UR2 (BRAVIA_UR2_4K, MediaTek) | Android TV 10 |
| Sony BRAVIA XBR-65X900E (2017, BRAVIA_ATV2) | Android TV 9 |
| Stellamore T950S projector (Droidlogic be30a3, Amlogic txhd2) | Android 13 |
| TCL 55" 4K Google TV, 2023 (G10, G10_4K_US_NF) | Google TV 12 |
| TCL 65C725 (Smart TV Pro, BeyondTV4) | Android TV 11 |
| TCL 55Q10G Pro (China, tcl_mt5879_cn, MediaTek MT9952) | Android TV 11 |
| TCL ak30a5 (China, Amlogic) | Android TV 9 |
| TCL BeyondTV (India) | Android TV 9 |
| TCL QM6K Pro, 2025 (G08, MediaTek tcl9618) | Google TV 14 |
| TCL Smart TV Pro (G05, G05_4K_US, MediaTek MT5889) | Google TV 11 |
| Toshiba Fire TV (AFTHA004, hazel) | Fire OS 7 / Android 9 |
| XGIMI Horizon S Pro projector (XK03H, xgimigalileo, MediaTek) | Android TV 11 |
| Xiaomi Mi Box S (MIBOX4, oneday), streaming box | Android TV 9 |
| Xiaomi Mi TV (MiTV-MOOQ0, croods) | Android TV 10 |
| Xiaomi Mi TV 4A (MiTV-MOOQ1) | Android TV 10 |
| Xiaomi MiTV-AESP0 stick (aquaman, 1 GB) | Android TV 9 |
| Xiaomi MiTV-AXSO0 (dangal; Mi TV 4C Pro 2019 / 4A Pro) | Android TV 9 |
| Xiaomi MiTV-MOOR2 (venom, MediaTek) | Google TV 11 |
| Xiaomi MiTV-MSSP3 (machuca, MediaTek) | Android TV 11 |
| Xiaomi TV A Pro 75" 2026 (MiTV-MZTU0, river, MediaTek) | Google TV 14 |
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. The tools need Python 3 and nothing else.
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
TV_HOST=192.168.1.50 launcher/build-and-install.sh # build the launcher and make it Home
tools/theme.sh themes/aurora # push a theme; --reset removes it
| Tool | What it does |
|---|---|
tools/tv.py |
Pure-Python ADB client: shell, batch, push, pull. Works where the stock adb binary is blocked. |
tools/b64push.py |
Uploads large files such as APKs in base64 chunks and verifies the checksum. |
tools/disable.sh, restore.sh |
Apply or undo a debloat list. |
tools/theme.sh |
Push a folder from themes/ to the launcher and restart Home. |
launcher/build-and-install.sh |
Builds a shrunk release (about 250 KB), installs it, switches Home, and rolls back if Home does not land on it. |
Every script has a PowerShell twin next to it. On Windows with Android Studio installed nothing else is needed:
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
The install scripts ask the TV which launcher owns Home and only disable one they recognise
(tvlauncher or launcherx); pass STOCK_LAUNCHER=<package> (-StockLauncher) to override, or
none to leave it alone.
The launcher
A small native Android TV app (com.gathin.tvhome, about 250 KB installed) in plain Java with
AndroidX RecyclerView and nothing heavier. Built for sets with 1 GB of RAM: no blur, no video, no
network, no background services. It needs JDK 17 and Android SDK platform 34 to build; on macOS,
brew install openjdk@17 android-commandlinetools and `sdkmanager "platforms;android
Frequently Asked Questions
What is cleanyourtv?
cleanyourtv is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Gathin23. Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home. It has 3,402 GitHub stars.
Is cleanyourtv safe to use?
cleanyourtv's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
How do I install cleanyourtv?
Clone the repository with "git clone https://github.com/Gathin23/cleanyourtv" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is cleanyourtv written in?
cleanyourtv is primarily written in Java. It is open-source under Gathin23 on GitHub, so you can review or fork the full source.
Are there alternatives to cleanyourtv?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh cleanyourtv against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
Reverse engineer anything with agents, from app behavior down to native binaries.
327,876
82,996
TypeScript
AI Agentsagent-skillsai-agents
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
283,526
42,114
JavaScript
AI Agentsai-agentsanthropic
Skills for Real Engineers. Straight from my .agents directory.
250,518
21,171
Shell
AI Agents
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming