Reading the repo
Reading the repo
How to install on macOS
Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.
Saved setup from 2 min ago
Will it work on my device?
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. |
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 · 83 | Sony · 49 | Xiaomi · 43 | Philips · 23 | Skyworth · 17 | Hisense · 16 | | SHARP · 10 | Amazon Fire TV · 9 | Panasonic · 7 | BenQ · 6 | Haier · 6 | JVC · 6 | | Toshiba · 6 | Acer · 4 | Formovie · 4 | Nokia · 4 | OnePlus · 4 | Thomson · 4 | | Artel · 3 | FFalcon · 3 | Google · 3 | Grundig · 3 | Motorola · 3 | Noblex · 3 | | NVIDIA Shield · 3 | onn · 3 | RCA · 3 | Redmi · 3 | RockTek · 3 | Vu · 3 |
<details> <summary>+78 more brands and 14 projector brands</summary>Challenger 2 · CHiQ 2 · EKO 2 · Hitachi 2 · Insignia Fire TV 2 · Kalley 2 · Kogan 2 · Master-G 2 · PRISM+ 2 · Sankey 2 · Sber 2 · Síragon 2 · TIM 2 · Vidda 2 · AiPro2K · AiPro4K · AIWA · AQUA · ASUS · Beko · Bell Canada · BGH · Caxium · Cecotec · Compac · Dcolor · DEXP · Dialog · Durabrand · DYON · Essentiel b · Freebox · HAAM · Hikeen · Home+ · Impex · INCLO · Jio · Karbonn · Kodak · Koryo · KTC · KUNFT · Liberton · Lumio · LYNCAST · Magyar Telekom · MarQ · MECOOL · MTC · Next · OK. · OPPO · Panavox · PEAQ · Philco · Polytron · PPTV · Prosonic · Salora · SANYO · Seleco · Smarttech · STRONG · SunWind · Super General · TD Systems · Tele System · Tesla · TiVo · Tornado · Turkcell · Tuvio · Verizon · VISIO · Vision · Vityas · X.Vision · Alwtniet, Anker Nebula, BYINTEK, Chihi, Epson, Gadnic, HOTACK, HY320, JMGO, Magcubic, Portronics, Stellamore, Wanbo and XGIMI projectors
</details> <!-- tv-brands:end -->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.
Compare yours with the README's “Supported TVs” list above before installing anything.
Needs Git: xcode-select --install
git clone https://github.com/Gathin23/cleanyourtv.git cd cleanyourtv
| 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 or Antigravity CLI.
| 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.
No reports for macOS yet.
Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.