Un paio di giorni fa ho visto il post di Ryan Doyle sull'uso di Claude Code per personalizzare la sua TV e ho pensato di provare a fare lo stesso con la mia.
https://x.com/doooyle/status/2111196679680540724
La mia TV è un Samsung 'The Frame' del 2024, con sistema operativo Tizen.
Odio lo Smart Hub di Samsung, o come diavolo lo chiamano, e volevo una schermata home più semplice, concentrata solo sulle app che uso davvero.
Per ora, ho chiamato la mia soluzione Clean Frame.
Da quando ho pubblicato qualche screenshot, mi hanno chiesto in tanti come sono riuscito a farlo funzionare su Samsung, se la TV continua a fare da cornice per l'arte e se condividerò la repo. Un paio di persone ci avevano già provato con Claude, ma si erano bloccate.
Personalmente non ho molto tempo per scrivere tutto questo, così ho chiesto a Codex di analizzare le nostre conversazioni, gli ho dettato qualcosa per qualche minuto e ha pubblicato quello che leggerete qui sotto.
Una rapida premessa:
Non sono assolutamente un esperto. Ci sono quasi certamente dei rischi, e modificare queste impostazioni potrebbe causare problemi o rendere la TV inutilizzabile. Se decidete di provarci, lo fate a vostro rischio e pericolo.
Installare un'app sulla TV
Ho iniziato in modo piuttosto prudente: prima di preoccuparmi dell'estetica, volevo capire se riuscivo anche solo a caricare una mia app sulla TV.
Ho usato Codex con Astra per gestire tutta la configurazione Samsung, partendo dalla Modalità Sviluppatore sulla TV e dalla connessione dal mio computer. Tizen offre strumenti di sviluppo per installare app personalizzate, quindi siamo partiti da lì.
L'app in sé è fatta solo di HTML, CSS e JavaScript. Gli strumenti di Samsung la impacchettano in modo che possa girare sulla TV. Tizen continua a gestire il televisore, e Clean Frame apre semplicemente le app di streaming già installate.
La prima versione era basilare. Potevo spostarmi tra un paio di app con il telecomando, premere OK e aprire Netflix o YouTube. Per quel momento, era tutto ciò che mi serviva testare.
La prima versione che ho testato e installato sulla TV.
Una volta verificato che funzionava, ho potuto iniziare a pensare a cosa volessi davvero mostrare sullo schermo.
Se volete provarci voi, ecco la configurazione:
- Collegate computer e TV alla stessa rete locale.
- Aprite App → Impostazioni app sulla TV e digitate 12345 con il tastierino numerico del telecomando.
- Attivate la Modalità Sviluppatore e inserite l'indirizzo IP locale del computer nel campo Host PC IP.
- Riavviate la TV, poi collegatevi dal computer usando gli strumenti di sviluppo di Samsung.
- Usate gli strumenti per i certificati di Samsung per creare un certificato autore e un certificato distributore. Aggiungete l'ID dispositivo (DUID) della vostra TV al certificato distributore, quindi impacchettate e installate l'app.
È facile confondere gli indirizzi. Sulla TV inserite l'IP del computer, mentre dal computer usate l'IP della TV per connettervi. La guida alla connessione di Samsung e la guida ai certificati spiegano tutto passo dopo passo.
Una volta installato lo strumento SDB di Samsung, questi sono i comandi per connettersi e verificare che la TV venga rilevata. Sostituite TV_IP con l'indirizzo locale della vostra TV:
1sdb connect TV_IP:261012sdb devices
Ho dovuto spegnere il mio Frame dall'interruttore a muro e riaccenderlo prima che il computer riuscisse a connettersi. Premere il tasto Power sul telecomando lo mandava semplicemente in Art Mode.
Ci è anche capitato che un'app venisse rifiutata per via del modo in cui l'avevamo firmata. Usare gli strumenti di pacchettizzazione ufficiali di Samsung ha risolto il problema.
Che prompt ho usato?
Qualcuno mi ha chiesto il prompt perché Codex segnalava errori nei loro tentativi. Altri hanno detto che Claude aveva risposto loro che non era possibile farlo su Tizen, o che erano riusciti solo a creare un'app personalizzata senza andare oltre. Non so cosa sia andato diversamente in quelle sessioni. Codex con Astra l'ha fatto funzionare sulla mia TV, e io ho proceduto un passo alla volta.
Questo è un esempio di come inizierei, non il prompt esatto della mia sessione:
1Aiutami a creare un launcher semplice per il mio Samsung Frame.2Controlla il mio modello e il firmware confrontandoli con la documentazione per sviluppatori di Samsung.3Inizia con un'app Tizen firmata di base che possa aprire un'app4di streaming già esistente. Lascia stare le impostazioni della Home e di avvio finché5non abbiamo fatto funzionare questo sulla TV.
Decidere l'aspetto grafico
Ho usato Codex e Claude Opus 5.5 per testare diversi design. Alcuni erano semplici liste con i nomi delle app in grande. Altri avevano una dock o una griglia sovrapposta a una foto. Vederli affiancati mi ha aiutato a capire cosa mi piaceva.
Shore Tiles, uno dei primi design a griglia in stile vetro che ho provato nel browser.
Da lì, ho continuato a ritoccare il layout, la tipografia e la sensazione d'uso con il telecomando.
Avevo anche un piccolo generatore di stili nel browser dove potevo combinare sfondi, font, layout ed effetti vetro diversi. Questo ha reso molto più facile capire cosa funzionava prima di caricarlo sulla TV.
Il generatore di stili, dove potevo confrontare le varie opzioni fianco a fianco.
Alla fine ho mantenuto una lista e una dock, con impostazioni per scegliere sfondo, font e icone. Posso anche decidere quali app mostrare e metterle nell'ordine che preferisco.
Il layout a lista, visualizzato nel browser.
Molti mi hanno chiesto se è veloce. All'inizio non lo era. L'effetto vetro era bellissimo nel browser, ma muoversi nella TV risultava lento. Due cose hanno risolto il problema: ottimizzare le immagini e pre-calcolare gli effetti vetro, invece di farli disegnare alla TV in tempo reale. Ora è super reattivo. Le app di streaming in sé impiegano comunque lo stesso tempo di prima per aprirsi.
Anche la lista delle app andava ripulita. Quando chiedevo a Tizen le app installate, mi restituiva centinaia di voci. Molte erano servizi in background, strumenti per gli account e app di sistema. Abbiamo aggiunto un filtro che controlla il nome e l'ID di ogni voce, tiene le app di streaming che uso e nasconde tutti quei componenti interni dal selettore. Restano comunque sulla TV a fare il loro lavoro. Questo pulisce solo la lista in Clean Frame; non le disinstalla né le disabilita.
Ho ingrandito i nomi delle app e dato loro più spazio, così sono più facili da leggere dal divano. Volevo anche che fosse subito evidente quale app avessi selezionato e che, chiudendo le Impostazioni, tornassi esattamente allo stesso punto. Su questi dettagli minori c'è stato un bel po' di avanti e indietro.
Impostarla come schermata home
Una volta soddisfatto del funzionamento, volevo poter premere Home e tornarci direttamente.
Abbiamo provato prima le impostazioni di avvio di Samsung. Ho disattivato Avvia con Smart Hub Home e attivato Esegui automaticamente l'ultima app. Così Clean Frame riappariva all'accensione della TV, a patto che fosse l'ultima app utilizzata.
Far sì che il tasto Home mi riportasse lì dopo aver guardato qualcosa ha richiesto un po' più di lavoro. Installare Clean Frame mi dava un'app da aprire, ma bisognava comunque dire alla TV di usarla come Home. Abbiamo usato un piccolo programma di supporto che viene eseguito una sola volta sulla TV tramite la connessione sviluppatore. Modifica l'impostazione Home della TV puntandola su Clean Frame e abilita l'avvio automatico per quell'app. Prima abbiamo salvato le impostazioni originali e verificato di poterle ripristinare.
L'ho testato con Netflix. Una volta aperto, ho premuto Home sul normale telecomando e sono tornato dritto a Clean Frame. Quindi potevo aprire un'app e poi tornare alla mia schermata home personalizzata con lo stesso tasto che uso di solito.
Se state cercando di fare lo stesso, sappiate che questa parte va oltre la configurazione delle app documentata da Samsung. Il mio è un Frame LS03D con firmware 2130.0. Il riferimento che abbiamo usato riguardava un altro modello Samsung, quindi l'abbiamo verificato sulla mia TV prima di procedere. Il programma di supporto doveva essere eseguito una sola volta, quindi non devo lasciare il Mac collegato per farlo funzionare.
Ha girato tramite la connessione sviluppatore e non ha richiesto i permessi di root. Tratterei comunque questa parte con cautela. Modifica le impostazioni Home della TV, e un modello o un firmware diverso potrebbe comportarsi in modo differente.
A che punto siamo
È installata sulla mia TV e funziona benissimo. Posso cambiare layout, font e sfondo, e tenere le app che voglio nell'ordine che preferisco.
Il telecomando normale funziona, premendo Home torno a Clean Frame e posso ancora usare la TV per esporre opere d'arte.
Ecco alcune combinazioni che sto provando. Posso cambiare sfondo, layout, font, stile del focus e l'aspetto delle app e dei controlli Home. Questi screenshot sono presi dall'app attuale in esecuzione nel browser.
Le impostazioni del Focus, con un'anteprima di come appaiono le tinte Glass e Clear nella Home.
Blue Peaks con il layout a lista, tipografia Mori, focus Type e icone per i controlli Home.
Solo testo su sfondo nero, con tipografia Mori e focus Type.
Mountain Valley con il layout a dock, materiale con tinta Clear e focus Glass.
Al momento in cui scrivo, molte persone mi hanno chiesto il link alla repo. Sto ancora sistemando un paio di cose e potrei aggiungerlo qui più avanti. Nel frattempo, questa guida dovrebbe portarvi a buon punto per creare la vostra, partendo dal modello e dal firmware della vostra TV e procedendo un passo alla volta.
Qualche domanda dai commenti
Posso ancora usarla come cornice per l'arte?
Sì. Funziona ancora. Gli sfondi di Clean Frame sono separati dall'Art Mode di Samsung.
Cosa succede quando Netflix o le altre app si aggiornano?
Restano le app installate e gestite dalla TV. Clean Frame si limita ad aprirle. Non sto mantenendo versioni separate di Netflix o YouTube. Un aggiornamento del firmware Samsung è un'altra questione: non ho ancora testato se la configurazione della Home regge dopo uno di quelli.
Hai sostituito Tizen o installato Android?
La TV usa ancora Tizen. Clean Frame è un'app Tizen, e ho solo cambiato l'impostazione Home in modo che si apra quando premo il tasto Home. Non ho installato Android né sostituito il sistema operativo della TV.
Funzionerà su altre TV?
Mi hanno chiesto di vecchi Samsung, LG, Hisense e Vizio: non ne ho la minima idea. Ma sembra esserci una lista sempre più lunga di persone che lo stanno facendo su tantissimi modelli e, da quanto vedo, Tizen sembra uno dei sistemi più ostici, quindi ci sono buone probabilità che la vostra TV funzioni.
L'interfaccia è in 4K?
L'interfaccia è costruita a 1920 × 1080 e si adatta allo schermo. Non ho creato una versione nativa in 4K. Questo è un discorso separato dalla qualità video all'interno delle app di streaming.
Funziona con Home Assistant?
Al momento non c'è un'integrazione con Home Assistant in Clean Frame. Finora mi sono concentrato sulla schermata home e sull'uso con il telecomando normale. Detto questo, alla fine è solo una web app e sarebbe abbastanza banale integrare molte altre funzionalità, quindi è molto probabile che si possa fare.
