Guia de configuração do CleanYourTV
Um ponto de partida para uma tela inicial de Android TV ou Google TV mais tranquila.
CleanYourTV é um projeto de código aberto de Gathin23. Este site é um guia independente e gratuito para o fluxo de trabalho do projeto. O pacote de código-fonte inclui o README do projeto, o prompt, exemplos de dispositivos, temas, notas de solução de problemas e notas de segurança.
Comece com o seu televisor exato
Confira o modelo, a região e o firmware nos relatórios de dispositivos em examples/, dentro do pacote de código-fonte extraído. Android TV e Google TV são os pontos de partida compatíveis. O prompt de instalação não oferece suporte a Fire TV, Samsung Tizen ou LG webOS.
Prepare o televisor
Mantenha o televisor e o computador na mesma rede local. Abra Configurações, depois Sobre, e pressione a entrada Build sete vezes para desbloquear as Opções do desenvolvedor. Ative a depuração USB e a depuração de rede/ADB, se disponíveis. Aprove apenas uma solicitação de depuração do seu próprio computador confiável.
Encontre o endereço IPv4 do televisor nas configurações de Rede ou Wi-Fi e informe-o ao assistente. O formulário de configuração deste site pode incluir esse endereço no prompt inicial; ele não verifica nem se conecta à sua rede.
Alguns aparelhos Google TV usam depuração sem fio com um código de pareamento e uma porta de conexão separada. Se a conexão normal não funcionar, siga o caminho de pareamento no prompt de instalação em vez de presumir que a porta 5555 está sempre aberta. O guia de solução de problemas de conexão explica o que verificar.
Siga o fluxo de trabalho atual do projeto
Abra o prompt de instalação, copie todo o texto para um assistente de programação com acesso ao terminal e informe o modelo exato. Peça para ele avançar por etapas de confirmação. O projeto é gratuito; alguns assistentes de programação cobram separadamente pelo uso.
Antes de fazer alterações, salve as listas de pacotes, os estados de pacotes desativados, as configurações e as informações do dispositivo. Confirme quais aplicativos de streaming, assistente de voz, serviços de transmissão e atualizações você quer manter. Não desative pacotes desconhecidos nem componentes essenciais de entrada, controle remoto, áudio, teclado ou serviços do Play.
O launcher é compilado a partir do código-fonte. Baixe o ZIP completo do código-fonte e extraia-o. Mantenha toda a pasta do projeto: os scripts de compilação também precisam de arquivos de tools/ e launcher/.
Prepare Python 3, JDK 17, Android SDK Platform 34 e Android Build Tools 34.0.0. O README.md extraído contém os detalhes da configuração manual. Baixe o script de compilação para Windows ou o script de compilação para macOS/Linux, coloque-o no diretório launcher/ extraído e execute-o ali; são scripts de compilação do código-fonte, não downloads de APKs prontos.
Antes de o novo launcher se tornar o Home, mantenha o launcher original ativado até que o substituto seja aberto com sucesso. Verifique o botão Home no televisor em vez de confiar apenas na mensagem de sucesso de um comando.
Alguns firmwares bloqueiam aplicativos instalados por sideload ou launchers Home de terceiros. Se o dispositivo rejeitar a instalação por causa de uma restrição de verificação ou assinatura do fabricante, pare a instalação do launcher e leia as notas do modelo exato. Tentar instalar repetidamente não comprova compatibilidade.
Verifique e finalize
Verifique o Home, os botões de atalho e Configurações do controle remoto, as entradas HDMI, o som e a transmissão. Desative a depuração, revogue as autorizações, reinicie e use a ferramenta baixável de verificação de ADB fechado para confirmar que a porta ADB recusa conexões. Um tempo limite ou erro de roteamento não é o mesmo que uma recusa confirmada.
Personalize o launcher
Quando a configuração básica funcionar, use as configurações do launcher para organizar as fileiras de aplicativos e decidir se quer manter as animações. O themes/README.md extraído explica como alterar o plano de fundo, as cores e o dock. Leia as instruções do tema antes de aplicá-lo e verifique novamente o controle remoto e o botão Home depois.
Restaure ou solucione problemas
Mantenha no computador as listas de pacotes originais e os registros de estado. Baixe o script de restauração para Windows ou o script de restauração para macOS/Linux, coloque-o no diretório tools/ extraído e use-o com a lista exata que você aplicou. Esses scripts restauram estados registrados; não são uma imagem completa do sistema. Para problemas específicos do modelo e orientações de segurança, leia docs/TROUBLESHOOTING.md e SECURITY.md dentro do pacote de código-fonte extraído.
Leia o passo a passo da restauração · Encontre uma etapa de solução de problemas