cleanyourtv
Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.
Install / Use
npx skills add Gathin23/cleanyourtvInstalls into whichever agent you are using.
CLAUDE.md
Claude Code project instructions
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of cleanyourtv
cleanyourtv scores 93/100 on our quality scale, 510th of 4,605 Development & Engineering skills we index (top 12%).
Its CLAUDE.md is 20 KB long, well organised into 11 sections with 4 code examples: a thorough specification that gives an agent plenty to work with.
With 4,752 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated today, so cleanyourtv is actively maintained.
- No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
- Its trust signals score 83/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
cleanyourtv compared with similar skills
All 4 of these similar skills score higher than cleanyourtv; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| cleanyourtv (this skill)by Gathin23 | 93 | 4.8k | today | CLAUDE.md |
| claude-memby thedotmack | 100 | 101.8k | today | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 99.6k | 4d ago | CLAUDE.md |
| taste-skillby Leonxlnx | 100 | 99.3k | today | CLAUDE.md |
| Understand-Anythingby Egonex-AI | 100 | 87.0k | 7d ago | CLAUDE.md |
Frequently asked questions
- How do I install cleanyourtv?
- Run
npx skills add Gathin23/cleanyourtv. The install tabs above show the steps for each supported agent. - Which AI agents does cleanyourtv work with?
- It is written for Claude Code, as a CLAUDE.md file. Other agents that read the same format can often use it too.
- Is cleanyourtv safe to use?
- It declares no license and scores 83/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is cleanyourtv still maintained?
- The repository was last updated today, so cleanyourtv is actively maintained.
Skill content
View source on GitHubStrip 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.
<h3 align="center">54 TVs with tested lists · 23 brands · 12 languages · 280 KB launcher</h3>
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.
| | |
|---|---|
| 
| 
|
| Top shelf and ambient glow | Inputs: HDMI with connection state, AV, Live TV |
| 
| 
|
| The grid, one glass highlight, the tile's name | Clock screensaver, drifts so nothing burns in |
| 
| 
|
| Aurora theme, pushed with tools/theme.sh | Six columns and a six-app dock, same launcher |
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 12 · TCL 11 · Sony 8 · CHiQ 2 · Hisense 2 · Philips 2 · Amazon Fire TV Stick · BenQ · Chromecast with Google TV · Hitachi · Insignia Fire TV · NVIDIA Shield · OnePlus · Panasonic · RCA · Redmi · SANYO · Skyworth · Thomson · Toshiba Fire TV · Vu · Stellamore and XGIMI projectors
<details> <summary><strong>The full list</strong></summary>| TV | OS | |---|---| | Amazon Fire TV Stick 4K, 1st gen 2018 (AFTMM, mantis) | Fire OS 6.7.1.1 / Android 7.1 | | BenQ E55-735 (Changhong AI PONT, DVB96BQ) | Google TV 14 | | CHiQ AI PONT (Changhong GTVU65, dangni, MediaTek mt5867) | Google TV 14 | | CHiQ AI PONT (DVB93CQ) | Android TV 11 | | Chromecast with Google TV 4K (sabrina) | Google TV 14 | | Hisense HiSmartTV A4 (xiaoyushan, MStar m7322), India | Android TV 9 | | Hisense SmartTV 4K FFM (huangshan, MediaTek) | Android TV 10 | | Hitachi 65QLEDSM20 (MTC, bangbae, MediaTek m7322), Australia | Android TV 11 | | 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 | | Panasonic 4KTV-JUP (Jupiter_PA, MediaTek) | Android TV 11 | | Philips 50PUS8517/12 (TP Vision, PH1M_EA_9970A, MediaTek MT5895), Europe | Android TV 11 | | 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 | | Redmi TV (MiTV-ANTL0, starwars) | Android 5.1.1 (not Android TV) | | SANYO ATV R2 (SCBC, Realtek RTD285O) | Android TV 9 | | Skyworth SWTV-21AE (sunnyvale, MediaTek) | Android TV 14 | | Sony BRAVIA 4K AE2 (BRAVIA_AE2, MediaTek MT5897), North America | Google TV 14 | | Sony BRAVIA 4K GB (BRAVIA_ATV2_EU, BRAVIA_ATV2) | Android TV 9 | | Sony BRAVIA 4K UR2 (BRAVIA_UR2_4K, MediaTek) | Android TV 10 | | Sony BRAVIA 4K VH2 (KD-55X80J, BRAVIA_VH2, MediaTek), EU | Google TV 12 | | Sony BRAVIA 9 II (K-65XR90M2, BRAVIA_AE3, MediaTek MT5838) | Google TV 14 | | Sony BRAVIA BF1 (BRAVIA 2 II class, BRAVIA_BF1_4K_A, MediaTek) | Google TV 12 | | Sony BRAVIA KD-65X80J (2021, BRAVIA_VH2, MediaTek), India | Google TV 10 | | Sony BRAVIA XBR-65X900E (2017, BRAVIA_ATV2) | Android TV 9 | | Stellamore T950S projector (Droidlogic be30a3, Amlogic txhd2) | Android 13 | | TCL 40S5400A (C06, C06_2K_GB, MediaTek MT9221, 1 GB) | Android TV 11 | | TCL 50EP680 (Europe, BeyondTV, Realtek rtd285o) | Android TV 11 | | TCL 55" 4K Google TV, 2023 (G10, G10_4K_US_NF) | Google TV 12 | | TCL 55Q10G Pro (China, tcl_mt5879_cn, MediaTek MT9952) | Android TV 11 | | TCL 65C725 (Smart TV Pro, BeyondTV4) | Android TV 11 | | TCL ak30a5 (China, Amlogic) | Android TV 9 | | TCL BeyondTV (India) | Android TV 9 | | TCL BeyondTV, EU/Nordic (Realtek RTD2851, V8-R851T02-LF1V606) | Android TV 9 | | TCL BeyondTV2 (Latin America / Brazil, Realtek RTD2851) | 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 | | Thomson 32HE5800 (TCL-built UnionTV, Realtek RT2841), Spain | Android TV 9 | | Toshiba Fire TV (AFTHA004, hazel) | Fire OS 7 / Android 9 | | Vu 4K (HVCL, lushan, MediaTek), India | Google TV 12 | | XGIMI Horizon S Pro projector (XK03H, xgimigalileo, MediaTek) | Android TV 11 | | Xiaomi Mi Box S (MIBOX4, oneday), streaming box | Android TV 9 | | Xiaomi Mi Box S 2nd gen (MiTV-AFKR0, jaws), streaming box | Google TV 11 | | 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-ASTP1 (maverick), China firmware 2.40.641.0514.cn, 1 GB RAM, 720p | Android TV 9 (CN build) | | Xiaomi MiTV-AXSO0 (dangal; Mi TV 4C Pro 2019 / 4A Pro) | Android TV 9 | | Xiaomi MiTV-MOOR2 (venom, MediaTek) | Google TV 11 | | Xiaomi MiTV-MOSR4 (irobot, 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 | | Xiaomi TV Box S 3rd gen (MiTV-AFMU0, twilight, Amlogic), streaming box | Google TV 14 |
</details>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](
Truncated for display — read the full file on GitHub.
Related Skills
claude-mem
101.8kPersistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Agent-Reach
99.6kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
taste-skill
99.3kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Understand-Anything
87.0kGraphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.