Enlever les pubs de ta télé avec Claude Code

L’origineD’où ça vient

Le 17 octobre 2026, un développeur, Gathin, en a eu assez de la publicité qui s’affichait sur la télé Xiaomi de ses parents avant même d’arriver à Netflix. Il a donné le modèle de la télé à Claude Code, qui l’a trouvée sur le Wi-Fi, a désactivé 25 paquets Xiaomi et a écrit un nouvel écran d’accueil. Son post a fait 8,6 millions de vues sur X d’après Cybernews, et il a publié son prompt sur GitHub le jour même.

Le dépôt s’appelle Gathin23/cleanyourtv, sous licence MIT. Le 31 octobre à 3 h, il avait 46 806 étoiles et 5 779 forks, et le README annonçait 380 modèles de télé testés, de 101 marques.

Avant toutTa télé est-elle compatible ?

C’est la première chose à vérifier, et elle élimine beaucoup de monde en France.

• Android TV et Google TV : oui. Ça couvre la plupart des Sony, Philips, TCL, Xiaomi, Thomson, Hisense sous Android, les boîtiers Chromecast avec Google TV et la Freebox Player Pop. Pour savoir, ouvre les paramètres de la télé, rubrique « À propos » : si tu vois une version d’Android TV, c’est bon.
• Fire TV : à moitié. Le nettoyage marche, mais Fire OS refuse de laisser l’écran d’accueil à un autre lanceur.
• Samsung (Tizen), LG (webOS), Roku, Vizio, Hisense VIDAA : non. Ces télés n’ont pas l’accès de débogage (ADB) dont l’outil a besoin. Pour elles, le projet a une page qui explique comment couper le pistage avec la télécommande.

La liste des modèles testés est sur cleanyour.tv/tvs.

Le matérielCe qu’il te faut

• Un ordinateur sur le même Wi-Fi que la télé, avec un terminal.
• Claude Code avec un abonnement Claude. Le dépôt marche aussi avec Codex, Gemini CLI ou Antigravity CLI.
• Python 3, un JDK entre 17 et 22, et le SDK Android (plateforme 34, build-tools 34) : l’agent s’en sert pour compiler le nouvel écran d’accueil.
• Environ quinze minutes, d’après le README, en restant devant la télé pour accepter ses demandes.

Sur Mac, s’il te manque Java ou le SDK Android :

brew install openjdk@17 android-commandlinetools
sdkmanager "platforms;android-34" "build-tools;34.0.0"

Étape 1 / 3Sur la télé : ouvrir le débogage

Paramètres, puis Préférences de l’appareil, puis À propos. Appuie sept fois sur OK sur la ligne « Build » : un message dit que tu es développeur. Reviens en arrière, ouvre « Options pour les développeurs » et active « Débogage USB ». Si tu vois aussi un réglage « Débogage réseau » ou « Débogage ADB », active-le. Les noms changent un peu selon la marque et la langue.

Laisse la télé allumée. Note son adresse IP : elle est dans les paramètres réseau (sur la Freebox Pop : Paramètres, Réseau et Internet).

Étape 2 / 3Sur l’ordinateur : cloner le dépôt et coller le prompt

Clone le dépôt et ouvre ce dossier dans Claude Code :

git clone https://github.com/Gathin23/cleanyourtv
cd cleanyourtv
claude

Ouvre ensuite le fichier PROMPT.md du dépôt, copie la partie sous la ligne de tirets et colle-la dans Claude Code. Remplace la ligne « My TV model is: <MODEL NAME HERE>. » par le vrai modèle de ta télé, par exemple :

My TV model is: Freebox Player POP.

Le clone compte : avec le dépôt ouvert, l’agent réutilise tools/disable.sh et launcher/build-and-install.sh au lieu d’écrire ses propres scripts, et c’est là que vivent la sauvegarde et la restauration.

Étape 3 / 3Suivre l’agent

La télé affiche « Autoriser le débogage USB ? » : accepte. L’agent sauvegarde la liste des applis et les réglages, puis il te pose des questions avant de toucher à ce que tu pourrais utiliser : tes applis, la taille du dock et l’ordre des applis, l’assistant vocal, Chromecast, les mises à jour.

Il désactive le reste avec pm disable-user (rien n’est désinstallé), compile le nouvel écran d’accueil, l’installe et vérifie chaque étape avec des captures prises sur la télé.

Le résultatCe que tu obtiens

Un écran d’accueil noir façon Apple TV : un dock de tes quatre applis préférées, le nom de l’appli sélectionnée en grand avec une lueur de sa couleur, le reste de tes applis dans une grille, l’heure, et trois boutons pour les entrées HDMI, le réseau et les réglages. Le lanceur entier pèse 572 Ko.

Tu peux changer les couleurs, le fond, le dock et le nombre de colonnes avec un thème, sans recompiler :

tools/theme.sh themes/aurora

En FranceLe cas de la Freebox Player Pop

Le dépôt a une liste testée pour elle (examples/freebox-player-pop/, Android TV 10). Ce qu’elle désactive : les statistiques d’usage de Free, les rapports envoyés à Google, les rangées de recommandations, l’installation automatique d’applis partenaires et des restes de tests d’usine. Les applis de replay, jeunesse et de Free sont coupées aussi, par choix de l’auteur : commente leurs lignes si tu t’en sers.

Ce qu’elle laisse en place : la télé elle-même (OQEE et le tuner TNT), la télécommande, la facturation des applis partenaires, le Play Store.

Trois choses à savoir sur ce boîtier

• L’écran d’accueil d’origine est OQEE. Le script d’installation se lance avec STOCK_LAUNCHER=net.oqee.launcher et ne désactive OQEE qu’une fois le nouveau lanceur démarré.
• Garde Chromecast si tu utilises Spotify : Spotify Connect passe par lui.
• Un DNS bloqueur de pubs casse Spotify sur ce boîtier. Si tu en mets un, autorise pixel.spotify.com.

Le retourRevenir en arrière

Avant le premier changement, l’outil enregistre l’état de la télé dans ~/.cleanyourtv/ sur ton ordinateur. Garde ce dossier et la liste que tu as appliquée. Pour tout remettre comme avant :

TV_HOST=<ip de la télé> tools/restore.sh examples/<ta télé>/debloat.txt

Sur Google TV, ajoute com.google.android.apps.tv.launcherx à la fin ; sur la Freebox Pop, net.oqee.launcher. Sans ordinateur, la page Applications des paramètres de la télé permet aussi de réactiver une appli.

Les limitesCe qu’il faut savoir avant

• Les mises à jour du fabricant défont le ménage. Les applis de la liste reviennent et l’écran d’origine reprend la main. Le dépôt a un outil pour le voir et tout remettre : tools/check.py, puis la même commande avec --fix.
• Désactiver une appli peut casser une fonction. Le guide de dépannage du dépôt (docs/TROUBLESHOOTING.md) liste les cas connus, dont des télés qui redémarrent en boucle quand l’écran d’origine est coupé avant que le nouveau soit en place. Si la télé ne démarre plus assez pour ADB, la sortie de secours est une réinitialisation d’usine depuis son menu de récupération.
• Ferme l’accès ADB quand tu as fini. Sur certaines télés, n’importe quel appareil du réseau peut s’y connecter. Coupe le débogage dans les options pour les développeurs, redémarre la télé, puis vérifie depuis l’ordinateur avec python3 tools/adb-closed.py suivi de l’adresse IP de la télé. Le nouvel écran d’accueil continue de marcher sans.
• Ta garantie et tes conditions d’abonnement. Elles restent sous ta responsabilité, surtout sur un boîtier fourni par ton opérateur.

La commande qui compare la télé à la liste appliquée, après une mise à jour :

tools/venv/bin/python -I tools/check.py examples/<ta télé>/debloat.txt

Questions fréquentesAvant de te lancer