Há alguns dias, vi o post do Ryan Doyle sobre usar o Claude Code para personalizar a TV dele e pensei em ver o que eu conseguiria fazer com a minha.
https://x.com/doooyle/status/2111196679680540724
Minha TV é uma Samsung 'The Frame' de 2024, rodando Tizen.
Eu odeio o Smart Hub da Samsung, ou seja lá como eles chamam isso, e queria uma tela inicial mais simples, focada nos apps que eu realmente uso.
Por enquanto, batizei minha solução para isso de Clean Frame.
Depois de postar algumas capturas de tela, recebi várias perguntas sobre como fiz funcionar na Samsung, se ela ainda funciona como uma Frame para exibir arte e se vou compartilhar o repositório. Algumas pessoas já tinham tentado com o Claude e travaram no meio do caminho.
Pessoalmente, não tenho muito tempo para escrever tudo isso, então pedi ao Codex para revisar nossas conversas, ditei para ele por alguns minutos e ele publicou o que você vai ler abaixo.
Um aviso rápido:
Não sou especialista nisso de jeito nenhum. Quase certamente existem riscos aqui, e alterar essas configurações pode causar problemas ou deixar sua TV inutilizável. Se for tentar, faça por sua conta e risco.
Colocando um app na TV
Comecei de forma bem conservadora: antes de me preocupar com a aparência, queria ver se conseguia pelo menos colocar meu próprio app na TV.
Usei o Codex com o Astra para passar pela configuração da Samsung, começando pelo Modo Desenvolvedor na TV e pela conexão a partir do meu computador. O Tizen tem ferramentas de desenvolvedor para instalar seus próprios apps, então foi por aí que começamos.
O app em si é só HTML, CSS e JavaScript. As ferramentas da Samsung empacotam tudo isso para que possa rodar na TV. O Tizen continua comandando a TV, e o Clean Frame abre os apps de streaming que já estão instalados nela.
A primeira versão era bem básica. Eu conseguia alternar entre alguns apps com o controle remoto, apertar OK e abrir o Netflix ou o YouTube. Era só isso que eu precisava testar naquele momento.
A primeira versão que testei e instalei na TV.
Quando isso funcionou, pude começar a pensar no que eu realmente queria colocar na tela.
Se você for tentar por conta própria, aqui está a configuração:
- Coloque o computador e a TV na mesma rede local.
- Abra Apps → Configurações de Apps na TV e digite 12345 usando o teclado numérico do controle remoto.
- Ative o Modo Desenvolvedor e insira o endereço IP local do computador no campo Host PC IP.
- Reinicie a TV e conecte-se a partir do computador usando as ferramentas de desenvolvimento da Samsung.
- Use as ferramentas de certificado da Samsung para criar um certificado de autor e um certificado de distribuidor. Adicione o ID do dispositivo (DUID) da sua TV ao certificado de distribuidor e, em seguida, empacote e instale seu app.
É fácil confundir os endereços. Você digita o IP do computador na TV e depois usa o IP da TV para conectar a partir do computador. O guia de conexão da Samsung e o guia de certificados explicam o passo a passo.
Depois de instalar a ferramenta SDB da Samsung, estes são os comandos para conectar e verificar se a TV aparece. Substitua TV_IP pelo endereço local da sua TV:
1sdb connect TV_IP:261012sdb devices
Tive que desligar minha Frame direto na tomada e ligar de novo para o computador conseguir conectar. Apertar o botão Power no controle apenas a colocava no Modo Arte.
Também tivemos um app rejeitado por causa da forma como o assinamos. Usar as próprias ferramentas de empacotamento da Samsung resolveu isso.
Qual prompt eu usei?
Alguém pediu o prompt porque o Codex estava bloqueando a tentativa dessa pessoa. Outros disseram que o Claude havia afirmado que isso não era possível no Tizen, ou que só tinha conseguido chegar até a criação de um app personalizado. Não sei o que houve de diferente nessas sessões. O Codex com o Astra fez funcionar na minha TV, e eu fui avançando um passo de cada vez.
Este é um exemplo de por onde eu começaria, e não o prompt exato da minha sessão:
1Me ajude a criar um launcher simples para a minha Samsung Frame.2Verifique meu modelo e firmware na documentação de desenvolvedor da Samsung.3Comece com um app Tizen básico e assinado que consiga abrir um app4de streaming já existente. Deixe as configurações de Home e de inicialização5como estão até conseguirmos fazer isso funcionar na TV.
Definindo a aparência
Usei o Codex e o Claude Opus 5.5 para testar alguns designs. Alguns eram listas simples com nomes de apps grandes. Outros tinham um dock ou uma grade sobre uma foto. Vê-los lado a lado me ajudou a entender do que eu gostava.
Shore Tiles, um dos primeiros designs com grade de vidro que testei no navegador.
A partir daí, continuei ajustando o layout, a tipografia e a sensação de uso com o controle remoto.
Eu também tinha um pequeno construtor de aparência no navegador, onde podia testar diferentes fundos, fontes, layouts e efeitos de vidro juntos. Isso facilitou ver o que funcionava antes de colocar na TV.
O construtor de aparência, onde eu podia testar as diferentes opções lado a lado.
No fim, mantive uma lista e um dock, com configurações para escolher o fundo, as fontes e os ícones. Também posso escolher quais apps aparecem e colocá-los na ordem que quiser.
O layout de lista, exibido no navegador.
As pessoas perguntaram se é rápido. Não começou assim. O efeito de vidro ficava ótimo no navegador, mas navegar parecia lento na TV. Duas coisas resolveram isso: otimizar as imagens e preparar os efeitos de vidro antecipadamente, em vez de fazer a TV renderizá-los na hora. Agora está super responsivo. Os apps de streaming em si continuam levando o mesmo tempo para abrir.
A lista de apps também precisava de uma limpeza. Quando pedia ao Tizen os apps instalados, ele retornava centenas de entradas. Muitas eram serviços em segundo plano, ferramentas de conta e apps do sistema. Adicionamos um filtro que verifica o nome e o ID de cada entrada, mantém os apps de streaming que eu uso e deixa esses componentes internos fora do seletor. Eles continuam na TV fazendo seu trabalho. Isso apenas limpa a lista no Clean Frame; não os desinstala nem desativa.
Deixei os nomes dos apps maiores e dei mais espaço a eles para facilitar a leitura do sofá. Também queria que ficasse óbvio qual app eu havia selecionado e que o sistema voltasse ao mesmo lugar após fechar as Configurações. Houve bastante vai e volta nesses detalhes menores.
Transformando-o na tela inicial
Quando fiquei satisfeito com o funcionamento, quis poder apertar o botão Home e voltar para ele.
Primeiro tentamos as configurações de inicialização da Samsung. Desativei Iniciar com o Smart Hub Home e ativei Executar automaticamente o último app. Isso fazia o Clean Frame voltar quando eu ligava a TV, desde que fosse o último app que eu havia usado.
Fazer o botão Home me trazer de volta depois de assistir a algo deu um pouco mais de trabalho. Instalar o Clean Frame me deu um app que eu podia abrir, mas a TV ainda precisava ser instruída a usá-lo como Home. Usamos um pequeno programa auxiliar que roda uma única vez na TV através da conexão de desenvolvedor. Ele altera a configuração de Home da TV para apontar para o Clean Frame e ativa a inicialização automática desse app. Salvamos as configurações originais primeiro e verificamos se podíamos restaurá-las.
Testei isso com o Netflix. Com ele aberto, apertei Home no controle remoto normal e voltei direto para o Clean Frame. Ou seja, eu podia abrir um app e depois voltar para a minha própria tela inicial com o mesmo botão que normalmente usaria.
Se você estiver tentando fazer o mesmo, saiba que essa parte vai além da configuração de apps documentada pela Samsung. A minha é uma Frame LS03D rodando o firmware 2130.0. A referência que usamos era para um modelo diferente da Samsung, então conferimos tudo na minha TV antes de fazer a alteração. O programa auxiliar só precisou rodar uma vez, então não preciso deixar meu Mac conectado para que funcione.
Ele rodou pela conexão de desenvolvedor e não precisou de acesso root. Ainda assim, eu trataria essa parte com cuidado. Ela altera as configurações de Home da TV, e um modelo ou firmware diferente pode se comportar de outra forma.
Em que pé estamos
Está instalado na minha TV e funcionando bem. Posso mudar o layout, as fontes e o fundo, e manter os apps que quero na ordem que preferir.
O controle remoto normal funciona, apertar Home me traz de volta ao Clean Frame e ainda posso usar a TV para exibir arte.
Aqui estão algumas combinações que venho testando. Posso alterar o fundo, o layout, a fonte, o estilo de foco e como os apps e os controles de Home aparecem. Estas capturas de tela são do app atual rodando no navegador.
As configurações de Foco, com uma prévia de como as tonalidades Glass e Clear ficam na tela inicial.
Blue Peaks com o layout de lista, tipografia Mori, foco Type e ícones para os controles de Home.
Apenas texto em preto, com tipografia Mori e foco Type.
Mountain Valley com o layout de dock, material de tonalidade Clear e foco Glass.
No momento em que escrevo isto, muita gente pediu o link do repositório. Ainda estou resolvendo algumas coisas e talvez o adicione aqui mais tarde. Enquanto isso, este guia deve te levar quase até o final na criação do seu próprio, começando pelo modelo e firmware da sua TV e avançando um passo de cada vez.
Algumas perguntas das respostas
Ainda posso usá-la como uma Frame para arte?
Sim. Isso continua funcionando. Os fundos no Clean Frame são separados do Modo Arte da Samsung.
O que acontece quando o Netflix ou outros apps atualizam?
Eles continuam sendo os apps instalados e gerenciados pela TV. O Clean Frame apenas os abre. Não estou mantendo versões separadas do Netflix ou do YouTube. Uma atualização de firmware da Samsung é outra história: ainda não testei como a configuração de Home se comporta após uma delas.
Você substituiu o Tizen ou instalou o Android?
A TV continua rodando Tizen. O Clean Frame é um app Tizen, e eu mudei a configuração de Home para que ele abra quando aperto o botão Home. Não instalei Android nem substituí o sistema operacional da TV.
Isso vai funcionar em outras TVs?
Perguntaram sobre Samsungs mais antigas, LG, Hisense e Vizio — não faço ideia quanto a essas. Mas parece haver uma lista crescente de pessoas fazendo isso em vários modelos e, pelo que vejo, o Tizen parece ser um dos mais difíceis, então há uma boa chance de funcionar na sua TV.
A interface é em 4K?
A interface é construída em 1920 × 1080 e escala para caber na tela. Não criei uma versão nativa em 4K. Isso é diferente da qualidade de vídeo dentro dos apps de streaming.
Funciona com o Home Assistant?
Não há integração com o Home Assistant no Clean Frame no momento. Até agora, foquei na tela inicial e no uso com o controle remoto normal. Dito isso, no fim das contas é apenas um app web, e você poderia incorporar muitas outras funcionalidades de forma bem trivial, então é bem provável que isso seja possível.
