Riccardo Belli. Risorsa · Clean your TV
// risorsa · dal reel

La TV pulita
con Claude Code

Clean your TV è un progetto gratuito su GitHub. Claude Code trova la TV sul Wi-Fi, spegne pubblicità, app del produttore e tracciamento, poi installa una schermata pulita tipo Apple TV. Qui trovi cosa ti serve, il prompt in italiano e come tornare indietro.

Funziona solo su TV Android e Google TV. Xiaomi, TCL, Sony, Philips, Hisense con Google TV, Nvidia Shield e molte altre. Samsung e LG no. Nemmeno Roku o Hisense VIDAA: su quelle il tracciamento lo spegni a mano dai menu, il progetto ha una guida su cleanyour.tv/not-android. Su Fire TV si fa solo una parte della pulizia, a mano.
Tool
Clean your TV
Tempo
~15 min più il setup
Aggiornata
2 novembre 2026
Claude Code Android TV Google TV GitHub
Scorri

Parti da qui: il tool

Open source
Gathin23/cleanyourtv50.276

È nato da un post su X di Gathin, il 17 ottobre. Ha dato a Claude Code il modello della TV dei suoi genitori, una Xiaomi: Claude l'ha trovata sul Wi-Fi, ha spento 25 app del produttore e ha scritto da zero una schermata Home nuova. Il 25 vale per quella TV, sulla tua il numero cambia.

Oggi è un progetto con licenza MIT e gli elenchi provati da chi l'ha usato coprono 420 modelli di 108 marche. Le app vengono disattivate, mai disinstallate. Non serve il root e il firmware non si tocca.

Attenzione ai siti falsi. Il sito vero del progetto è cleanyour.tv, insieme al repository qui sopra. cleanyourtv.com e clean-your-tv.net sono truffe che usano il nome: il progetto non li gestisce. Clean your TV non pubblica app negli store, quindi un'app con quel nome che trovi lì non è loro.
01Requisiti

Cosa ti serve

Prima di iniziare
  1. Una TV Android o Google TV. Per la schermata nuova serve Android 8.0 o successivo. Sulle TV più vecchie si fa solo la pulizia.
  2. Un computer sulla stessa rete Wi-Fi della TV, con Claude Code.
  3. Python 3, per lo strumento che parla con la TV.
  4. Un JDK dalla versione 17 alla 22, quello completo. Dal 23 in poi la compilazione della schermata nuova si ferma.
  5. Android SDK Platform 34 e Build Tools 34, per compilare la schermata nuova.
  6. Una sessione sola, con la TV accesa dall'inizio alla fine.

Su Mac il JDK e l'SDK si installano così, con Homebrew:

JDK e Android SDK su Macterminale
brew install openjdk@17 android-commandlinetools
sdkmanager "platforms;android-34" "build-tools;34.0.0"

Su Windows installi Python e Android Studio, che porta con sé JDK e SDK. Se non vuoi installare niente di tutto questo, il repository compila la schermata nuova anche dentro Docker.

02Sulla TV

Accendi il debug

2 minuti
  1. Vai in Impostazioni → Sistema (o Preferenze dispositivo) → Informazioni. I nomi dei menu cambiano da TV a TV.
  2. Premi OK sette volte su Build. La TV ti dice che sei diventato sviluppatore.
  3. Torna indietro e apri Opzioni sviluppatore. Attiva il debug USB.
  4. Se c'è, attiva anche il debug di rete (o ADB di rete). Molte Google TV hanno invece il debug wireless: Claude Code ti chiederà il codice di abbinamento.

Alcune TV tolgono corrente alla porta USB mentre il debug è attivo. Se ci hai collegato una chiavetta, una cassa o un adattatore Ethernet, smette di funzionare finché non spegni il debug. Per questo il lavoro va fatto tutto in una volta.

03Sul computer

Scarica il progetto

1 minuto

Clona il repository e apri Claude Code dentro la sua cartella. Così Claude usa gli strumenti del progetto, con i loro controlli di sicurezza e il backup, invece di scriverne di suoi.

Clona e apriterminale
git clone https://github.com/Gathin23/cleanyourtv
cd cleanyourtv
claude
04Il prompt

Incollalo in Claude Code

Prompt

È il prompt del progetto tradotto: la richiesta e i passi principali in italiano, con il modello della tua TV tra parentesi quadre. Per ogni dettaglio Claude Code legge il prompt originale in inglese, che sta nella cartella e viene aggiornato quasi ogni giorno.

Clean your TV in italianometti il tuo modello
Voglio ripulire la mia Android TV e sostituire la sua schermata Home con una Home pulita in stile Apple TV.
Il modello della mia TV è: [MODELLO DELLA TV]
Lavora sulla TV vera un passo alla volta e controlla tutto quello che fai con screenshot presi dalla TV.
Chiedimi prima di fare qualsiasi cosa che dipende dai miei gusti.

Siamo nella cartella del repository cleanyourtv. Leggi PROMPT.md per intero e seguilo alla lettera:
è la procedura completa, con tutti i controlli di sicurezza. Usa gli strumenti che ci sono già in tools/
e launcher/ invece di scriverne di tuoi. Se in examples/ c'è l'elenco del mio modello, parti da quello.

In ordine:
1. Collegati: trova la TV sulla rete e collegati in ADB sulla porta 5555. Dimmi quando sulla TV compare
   la richiesta di autorizzare il debug, così la accetto. Se la TV non è Android TV o Google TV, fermati e dimmelo.
2. Backup: prima di cambiare qualsiasi cosa salva l'elenco completo delle app, quelle già disattivate,
   getprop e tutte le impostazioni. Poi scrivi uno script che riattiva tutto quello che disattivi.
   Chiedimi cosa c'è collegato alle porte USB della TV e se la rete arriva da un adattatore Ethernet USB.
3. Pulizia: dividi le app in telemetria, pubblicità e contenuti del produttore, servizi in background
   che non mi servono, app preinstallate e app di streaming. Disattivale con pm disable-user --user 0
   a piccoli lotti, con uno screenshot fra un lotto e l'altro. Mai disinstallare le app di sistema.
   Non toccare mai quello che serve alla TV per funzionare (app TV e ingressi HDMI, telecomando
   e Bluetooth, tastiera, Play Store e Play Services) né i pacchetti di base di Android elencati in PROMPT.md.
   Prima di toccare app di streaming, assistente vocale, Chromecast, Miracast e aggiornamenti
   chiedimi con una lista quali uso.
4. Schermata Home: controlla che la TV accetti gli APK e la sua versione di Android, poi compila e installa
   il launcher del repository. Chiedimi quante app voglio nel dock (4, 5, 6 o 7), quali e in che ordine.
   Disattiva il launcher originale solo dopo che il nuovo è installato e funziona.
5. Verifica: dopo ogni modifica premi i tasti del telecomando via ADB, prendi uno screenshot dalla TV,
   guardalo e correggi quello che non va prima di andare avanti.
6. Alla fine dammi uno script di ripristino, uno per ricompilare e reinstallare e un README che spiega
   come riattivare un'app e come cambiare l'ordine del dock o lo sfondo. Poi chiudi l'ADB di rete:
   spegni debug di rete, debug wireless e debug USB, revoca le autorizzazioni, riavvia la TV
   e controlla con tools/adb-closed.py che la porta 5555 sia chiusa.
  1. Accetta la richiesta sulla TV quando Claude Code te lo dice: «Consentire il debug?», premi Consenti.
  2. Rispondi a tre o quattro domande. Quali app usi, quante ne vuoi nel dock e in che ordine, se tenere assistente vocale, Chromecast e aggiornamenti di sistema.
  3. Guarda gli screenshot. Claude Code ti mostra la TV dopo ogni lotto: se qualcosa non va lo vedi subito.
05Ripristino

Come tornare indietro

Sempre possibile

Prima di disattivare, lo strumento del progetto salva lo stato di ogni app dell'elenco e la Home di quel momento, in ~/.cleanyourtv/ sul computer.

  1. Chiedilo a Claude Code. Nella stessa cartella scrivi di riattivare tutto con lo script di ripristino. Oppure lo lanci tu, con l'IP della TV e l'elenco esatto che hai usato.
  2. Dalla TV, senza computer. In Impostazioni → App riattivi una per una le app disattivate. Da lì togli anche la schermata nuova, se non la vuoi più.
  3. Reset di fabbrica dal menu di ripristino della TV, se la TV non si avvia abbastanza per arrivare alle impostazioni.
Ripristino a manometti IP ed elenco
TV_HOST=[IP DELLA TV] tools/restore.sh [l'elenco che hai usato, per esempio examples/il-tuo-modello/debloat.txt]

Lo script rimette le app com'erano e ridà la Home al launcher originale. Le app che erano già disattivate prima restano disattivate.

06Da sapere

Quattro cose dopo

Avvertenze
  1. Un aggiornamento del firmware rimette qualcosa. Tornano le app dell'elenco, la Home originale e a volte app nuove. Riaccendi il debug e lancia tools/check.py con il tuo elenco: con --fix rimette tutto a posto.
  2. Gli aggiornamenti si possono spegnere per sbaglio. Alcuni elenchi disattivano il servizio di aggiornamento del sistema. Se vuoi il firmware nuovo, va riattivato.
  3. Spegni il debug quando hai finito. La porta 5555 non è cifrata e su alcune TV chiunque sulla rete di casa può collegarsi. La schermata nuova funziona anche con il debug spento.
  4. La garanzia. La TV deve essere tua e lo fai a tuo rischio. Il progetto avverte che cambiare il software della TV può toccare la garanzia o l'assistenza del produttore.
E adesso?

Una TV Android.
Un prompt.

Un quarto d'ora con la TV accesa e Claude Code aperto nella cartella del progetto. Se qualcosa non ti piace, lo script di ripristino rimette tutto com'era.

0
stelle su GitHub
0
modelli di TV provati
0
marche

Vuoi andare più a fondo?

Se vuoi impararlo per bene, dal primo comando a Claude Code, c'è il corso. Se invece hai un'azienda e vuoi portare l'AI dentro i processi, parliamone in una call.

Il corso su Claude → Parliamo del tuo progetto →
La risorsa che ti ho promesso. Clean your TV è open source, licenza MIT. Dati letti il 2 novembre 2026. Riccardo Belli.