cleanyourtv : débloater une TV Android ou Google TV

cleanyourtv est un projet open source qui retire le bloatware d’une TV Android ou Google TV en Wi-Fi, puis remplace l’écran d’accueil rempli de publicités par un lanceur sobre, inspiré de l’Apple TV. Pas de root, pas de câble, rien n’est désinstallé, et un script de restauration annule les changements. Le travail peut être confié à un assistant de code comme Claude Code, ou fait à la main.

En bref

• Désactive les applis du fabricant (pubs, télémétrie, contenus sponsorisés) sans rien désinstaller
• Installe un petit lanceur d’environ 250 Ko, avec un dock de quatre applis
• Fonctionne en Wi-Fi, sans root, grâce au débogage USB de la TV
• Un script de restauration remet les paquets et le lanceur d’origine
• Licence MIT, 54 listes de TV dans la version 2.3.0

Qu’est-ce que cleanyourtv ?

cleanyourtv est un dépôt GitHub publié par Gathin23. Il s’attaque à un défaut courant des TV Android et Google TV : un accueil qui affiche une publicité sponsorisée avant même de pouvoir ouvrir Netflix, des rangées de contenus imposés, de la télémétrie et des applis préinstallées que personne n’a demandées.

Le projet est né d’un message de son auteur sur X, le 17 octobre 2026. Il y raconte avoir donné à Claude Code le modèle de la TV de ses parents, une Xiaomi : l’assistant a trouvé la TV sur le Wi-Fi, retiré 25 paquets Xiaomi et écrit un nouveau lanceur. Le dépôt s’appelait tv-vibehack jusqu’au 19 octobre, et les anciens liens fonctionnent toujours.

Comment fonctionne cleanyourtv

Les TV Android disposent du même pont de débogage que les téléphones Android, appelé ADB. Tu actives le débogage USB dans les options pour les développeurs de la TV, tu autorises ton ordinateur une fois, et le reste repose sur des outils Android standard.

Le processus tient en trois étapes. Le projet sauvegarde d’abord la liste des paquets installés et des réglages. Il désactive ensuite la télémétrie, les services publicitaires, les rangées de contenus et les applis préinstallées du fabricant avec pm disable-user. Il installe enfin un petit lanceur natif et le définit comme écran d’accueil par défaut.

Comme les applis superflues diffèrent d’une marque à l’autre, le prompt demande à l’assistant de les repérer sur ta TV et de te poser la question avant de toucher à ce que tu pourrais utiliser.

Ce que change le nouveau lanceur

Le lanceur remplace l’accueil du fabricant par un écran noir, sobre, qui rappelle l’Apple TV. Il est écrit en Java, pèse environ 250 Ko et vise les TV équipées de 1 Go de RAM : ni flou, ni vidéo, ni réseau, ni service en arrière-plan.

Il propose aussi des thèmes qui changent couleurs, fond d’écran, dock et colonnes sans recompiler, ainsi que des cartes de module : une autre appli peut y déclarer sa propre tuile, mais seulement avec ton accord. L’interface suit la langue de la TV, avec douze langues dans la version 2.3.0, dont le français.

• Un dock de quatre applis favorites, dans une bande arrondie
• Un bandeau qui affiche en grand le nom de l’appli sélectionnée, avec une lueur tirée de son visuel
• Les autres applis en grille, qui remonte quand tu appuies sur Bas
• Trois boutons : entrées (HDMI, AV, TV en direct), réseau Wi-Fi ou Ethernet, réglages
• Un salut, l’heure, la date et un écran de veille horloge

Installer cleanyourtv sur ta TV

Il faut un ordinateur sur le même Wi-Fi que la TV et un assistant de code avec accès au terminal, comme Claude Code. Sur la TV, ouvre Réglages, Préférences de l’appareil, À propos, puis appuie sept fois sur OK sur Build. Reviens en arrière, ouvre les options pour les développeurs et active le débogage USB. Si un réglage de débogage réseau ou ADB apparaît, active-le aussi, et garde la TV allumée.

Sur l’ordinateur, colle le contenu du fichier PROMPT.md dans l’assistant et indique le modèle de ta TV. Accepte la demande « Allow USB debugging? » sur la TV, puis réponds à la liste de questions : applis utilisées, quatre applis du dock, assistant vocal, Chromecast et mises à jour à conserver. Avec le dépôt comme contexte, le README annonce environ quinze minutes.

Tu peux aussi tout lancer toi-même. Les outils demandent Python 3 et rien d’autre. Voici quelques commandes du README, où l’adresse IP est celle de ta TV :

python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50
tools/disable.sh examples/xiaomi-mi-tv-4a/debloat.txt
TV_HOST=192.168.1.50 launcher/build-and-install.sh

Quelles TV sont prises en charge ?

Le projet vise toute TV sous Android TV ou Google TV. Les TV Samsung (Tizen) et LG (webOS) tournent sur d’autres systèmes. Sur Fire TV, seule la partie nettoyage fonctionne, car Fire OS ne laisse pas un lanceur tiers prendre l’accueil. Quelques TCL vendues en Chine refusent tout lanceur, ce que leurs listes précisent.

Le dossier examples/ contient des listes testées par des contributeurs, une par modèle : 54 TV de 23 marques dans la version 2.3.0, dont des Xiaomi, TCL, Sony, Hisense, Philips et NVIDIA Shield. Si ton modèle manque, le prompt découvre lui-même les applis à désactiver, et tu peux ensuite ajouter ta liste.

Restaurer sa TV si tu changes d’avis

Rien n’étant désinstallé, le retour en arrière est possible. Le script de restauration réactive exactement les paquets de la liste appliquée, remet le lanceur d’origine comme accueil et réinitialise les échelles d’animation. Garde donc la liste utilisée. Le script laisse le nouveau lanceur installé, et ignore les paquets désactivés hors de cette liste.

Si la TV est injoignable, la page Réglages, Applis de la TV permet aussi de réactiver des paquets. Sur Google TV, le README signale un piège : désactiver le lanceur d’origine avant que le nouveau tourne peut faire atterrir l’accueil sur une appli de test. Le script d’installation respecte le bon ordre.

tools/restore.sh examples/xiaomi-mi-tv-4a/debloat.txt

Activité du projet et points à savoir

Au 20 octobre 2026, le dépôt compte 7 197 étoiles, 837 copies et 107 contributeurs, pour 49 tickets et demandes de fusion ouverts. Il a été créé le 17 octobre 2026, et la version 2.3.0 date du 19 octobre. L’auteur précise qu’il n’a pas encore testé cette version sur sa propre TV : elle compile et passe les tests automatiques, et chaque contributeur a testé sa partie sur son modèle.

Aucun fichier APK précompilé n’est proposé : il faut compiler le lanceur, ce qui demande JDK 17 et le SDK Android plateforme 34. Le projet est sous licence MIT. Le README conseille de couper le débogage USB une fois l’opération faite, le lanceur continuant de fonctionner.

Quelques repères

• Bloatware : Ensemble des applications préinstallées par un fabricant, que l’utilisateur n’a pas choisies et qui sont souvent difficiles à retirer.
• ADB : Outil de débogage d’Android qui permet à un ordinateur d’envoyer des commandes à un appareil, par câble ou par réseau, une fois l’accès autorisé.
• Lanceur : Application qui sert d’écran d’accueil sur un appareil Android : elle affiche les applications et permet de les ouvrir.

Questions fréquentes

cleanyourtv peut-il abîmer ma TV ?

Le projet indique que rien n’est flashé, rooté ni supprimé : les paquets sont désactivés dans le profil utilisateur. Le risque est de désactiver un élément dont la TV dépend, d’où l’application des listes par petits lots et un script de restauration.

cleanyourtv fonctionne-t-il sur une TV Samsung ou LG ?

Non, pas directement. Samsung (Tizen) et LG (webOS) utilisent d’autres systèmes. Le fichier SHOWCASE.md du dépôt mentionne seulement un portage pour webOS.

Faut-il du root ou un câble pour utiliser cleanyourtv ?

Non. Il faut activer le débogage USB sur la TV et autoriser l’ordinateur une fois, le tout en Wi-Fi.

cleanyourtv est-il gratuit ?

Oui, il est publié sous licence MIT. Le projet ne propose pas d’APK précompilé : le lanceur se compile avec le script fourni.

À retenir

cleanyourtv désactive le bloatware d’une TV Android ou Google TV avec ADB et installe un lanceur léger, sans rien désinstaller ni passer par le root. Un script de restauration permet de revenir à l’état d’origine, mais le projet est très récent et sa dernière version n’a pas encore été testée par son auteur sur sa propre TV.