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.
Parti da qui: il tool
Open sourceÈ 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.
Cosa ti serve
Prima di iniziare- 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.
- Un computer sulla stessa rete Wi-Fi della TV, con Claude Code.
- Python 3, per lo strumento che parla con la TV.
- Un JDK dalla versione 17 alla 22, quello completo. Dal 23 in poi la compilazione della schermata nuova si ferma.
- Android SDK Platform 34 e Build Tools 34, per compilare la schermata nuova.
- Una sessione sola, con la TV accesa dall'inizio alla fine.
Su Mac il JDK e l'SDK si installano così, con Homebrew:
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.
Accendi il debug
2 minuti- Vai in Impostazioni → Sistema (o Preferenze dispositivo) → Informazioni. I nomi dei menu cambiano da TV a TV.
- Premi OK sette volte su Build. La TV ti dice che sei diventato sviluppatore.
- Torna indietro e apri Opzioni sviluppatore. Attiva il debug USB.
- 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.
Scarica il progetto
1 minutoClona 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.
git clone https://github.com/Gathin23/cleanyourtv cd cleanyourtv claude
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.
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.
- Accetta la richiesta sulla TV quando Claude Code te lo dice: «Consentire il debug?», premi Consenti.
- 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.
- Guarda gli screenshot. Claude Code ti mostra la TV dopo ogni lotto: se qualcosa non va lo vedi subito.
Come tornare indietro
Sempre possibilePrima di disattivare, lo strumento del progetto salva lo stato di ogni app dell'elenco e la Home di quel momento, in ~/.cleanyourtv/ sul computer.
- 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.
- 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ù.
- Reset di fabbrica dal menu di ripristino della TV, se la TV non si avvia abbastanza per arrivare alle impostazioni.
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.
Quattro cose dopo
Avvertenze- 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.
- Gli aggiornamenti si possono spegnere per sbaglio. Alcuni elenchi disattivano il servizio di aggiornamento del sistema. Se vuoi il firmware nuovo, va riattivato.
- 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.
- 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.
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.
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.