Como Limpar a TV Android: CleanYourTV Passo a Passo

A TV nova chega com publicidade no ecrã inicial, apps que nunca pediste e serviços do fabricante a medir o que vês. Em outubro, um repositório do GitHub chamado CleanYourTV foi o mais popular da semana na plataforma e promete limpar uma TV Android ou Google TV por Wi-Fi, trocando o ecrã inicial por um launcher limpo, ao estilo da Apple TV. Neste guia explico o que o projeto faz, quais as TVs compatíveis, que cuidados convém ter e como ligar a TV limpa ao Home Assistant.

Este artigo cruza a nossa série Home Assistant do Zero à Prática com um dos temas mais quentes da casa inteligente: a privacidade da sala de estar. Já tínhamos falado dos anúncios no Google TV em Liberte o seu Google TV. Aqui vamos mais longe.

O que é o CleanYourTV e para que serve?

O CleanYourTV é um projeto de código aberto (licença MIT) que desativa a publicidade, a telemetria e as apps pré-instaladas de uma TV Android ou Google TV e instala um launcher de cerca de 572 KB como ecrã inicial. Funciona por Wi-Fi, sem root e sem apagar nada, e inclui um script de restauro.

O projeto indica listas de contribuidores para 433 modelos de 114 marcas e, segundo ele próprio, já teve mais de 400 artigos de imprensa.

Nota de transparência: este guia resume o que o projeto documenta, a partir do repositório oficial e de fontes externas. Antes de o aplicares na tua TV, lê a documentação e faz as tuas próprias verificações.

Porque está tanta gente a fazer isto

O ponto de partida é o que muita gente já sente: ecrã inicial com conteúdos patrocinados, TV lenta com pouca memória e serviços do fabricante a recolher dados. Segundo o próprio projeto, tudo começou com uma publicação viral a 17 de outubro de 2026, em que o autor limpou a TV dos pais com um assistente de código. Na semana de 19 a 25 de outubro foi o repositório n.º 1 em tendência, segundo o projeto e o trendshift.io. No início de novembro, a página mostrava mais de 52 mil estrelas e 6,6 mil forks.

A privacidade é a outra metade da história. O reconhecimento automático de conteúdo (ACR) é a técnica de algumas TVs para identificar o que está a passar no ecrã, e já fámámos dela em LG reage às acusações de espionagem e em Smart TVs sob suspeita. Um estudo da Northeastern University, noticiado em outubro de 2026, concluiu que TVs Samsung, Vizio e Roku continuam a trocar dados com servidores de reconhecimento de conteúdo mesmo depois de o utilizador desligar as opções nas definições. Por isso as pessoas procuram soluções mais fundo do que um interruptor.

Como funciona, sem root e sem desinstalar nada

As TVs Android têm a mesma «ponte de depuração» (ADB) dos telemóveis. Ativas a depuração USB nas opções de programador, autorizas o computador uma vez e o resto usa ferramentas normais do Android. O projeto descreve três passos:

1. Cópia de segurança. Guarda a lista de pacotes instalados e as definições.
2. Desativar. Desativa a telemetria, os serviços de anúncios, as linhas de conteúdos e as apps pré-instaladas com o comando pm disable-user. Nada é desinstalado, por isso o script de restauro consegue desfazer cada passo. É o mesmo efeito do botão «Desativar» em Definições, Apps.
3. Instalar. Um launcher nativo, pequeno, torna-se o ecrã inicial.

O launcher mostra uma dock com as quatro apps preferidas, uma linha de destaque com o nome da app em foco e uma grelha com as restantes. Tem temas, relógio como proteção de ecrã e foi feito para TVs com 1 GB de RAM, a partir do Android 8.0. Não pede permissão de rede nem usa serviços em segundo plano, segundo a documentação.

A tua TV é compatível?

Em Portugal, as TVs Samsung e LG são muito comuns, por isso muita gente fica de fora, e há uma secção a seguir para esse caso. Se estás a pensar comprar, as nossas análises de Sony BRAVIA 3, TCL 75V6D e Xiaomi TV Pro 43 são TVs com Google TV, a plataforma que o projeto suporta.

Três formas de o fazer

• Com um assistente de código. É o caminho principal do projeto: clonas o repositório, abres a pasta num assistente como o Claude Code, o Codex ou o Gemini CLI, colas o ficheiro PROMPT.md e respondes a uma lista de verificação. Demora cerca de quinze minutos, segundo o projeto, e o assistente pergunta antes de mexer em apps que possas usar.
• À mão, com os scripts. Exige Python 3, um JDK entre a versão 17 e a 22 (o 23 e superiores não funcionam) e o Android SDK 34, porque o launcher é construído no teu computador. É o mesmo trabalho, feito por ti. Há também uma opção com Docker e versões em PowerShell para Windows.
• Com apps independentes. Para quem não programa, o projeto lista apps gratuitas e de código aberto para telemóvel Android, Mac e Windows, feitas por programadores independentes. Mostram um plano primeiro, só desativam apps e podem repor tudo. Uma delas está na Google Play. Não são do projeto, e cada uma tem os seus riscos.

O processo, passo a passo

1. Na TV: abre Definições, Preferências do dispositivo, Acerca de, e carrega em OK sete vezes em «Build». Volta atrás, entra em Opções de programador e ativa a Depuração USB. Se existir uma opção de depuração por rede ou ADB, ativa também. Mantém a TV ligada.
2. No computador, na mesma rede Wi-Fi: clona o repositório e descobre o IP da TV.
3. Autoriza o computador quando a TV perguntar «Permitir depuração USB?».
4. Escolhe a lista da tua TV. O repositório tem uma pasta por modelo em examples/. Se o teu não existir, o prompt descobre o que desativar, e depois podes contribuir com a tua lista para a próxima pessoa.
5. Aplica a limpeza e instala o launcher. Os scripts só desativam o launcher original depois de o novo estar instalado e a funcionar.

Os comandos principais, para quem prefere fazer à mão, são estes, segundo a documentação do projeto:

git clone https://github.com/Gathin23/cleanyourtv
cd cleanyourtv
python3 -m venv tools/venv && tools/venv/bin/pip install -r tools/requirements.txt
export TV_HOST=192.168.1.50   # o IP da tua TV

tools/venv/bin/python -I tools/tv.py --probe          # modelo e versão
tools/disable.sh examples/<a-tua-tv>/debloat.txt        # aplica a limpeza
TV_HOST=192.168.1.50 launcher/build-and-install.sh     # instala o launcher
tools/restore.sh examples/<a-tua-tv>/debloat.txt        # desfaz tudo

Para uma TV específica, usa o ficheiro de examples/ que corresponda ao teu modelo. O endereço oficial do projeto é o cleanyour.tv e o repositório no GitHub. O projeto avisa que outros domínios com o mesmo nome, como cleanyourtv.com, não são dele, e que não publica nenhuma app em lojas.

Riscos e cuidados

• Cópia e restauro. Antes de mudar alguma coisa, o script grava o estado da TV no computador. Guarda a lista que aplicaste. O restauro volta a ativar os pacotes e o launcher original.
• Aplica em lotes pequenos. O risco é desativar algo de que a TV depende. O projeto recomenda aplicar listas em pequenas partes, com o script de restauro à mão. Em último caso, as Definições, Apps da própria TV também podem reativar pacotes.
• Google TV e o assistente de configuração. Depois de o launcher original ser desativado, o assistente de configuração (setupwraith) pode tomar conta do ecrã inicial e bloquear o sistema, por isso também é desativado. Se a rede Wi-Fi foi guardada durante a configuração, desativá-lo apaga-a, e convém voltares a ligar-te à rede antes. Nos aparelhos da própria Google (Chromecast e Google TV Streamer), isto custa também o envio a partir do telemóvel. Lê a secção de resolução de problemas do projeto antes.
• Atualizações de firmware. Uma atualização pode repor os pacotes. O projeto tem um script que compara a TV com a lista aplicada e corrige.
• Segurança do ADB. O ADB por rede não é cifrado e, em algumas TVs, qualquer dispositivo da rede local pode abrir uma shell. Quando acabares, desliga a depuração, revoga as autorizações e confirma que a porta 5555 ficou fechada. Nunca abras a porta no router.
• Garantia e suporte. Mudar o software de uma TV pode afetar a garantia ou o suporte. O projeto diz que o fazes numa TV tua, por tua conta e risco.
• Cuidado com cópias. O projeto não distribui APKs: constrói-se a partir do código. Desconfia de sites que ofereçam «o ficheiro pronto» e de domínios parecidos.

E se a TV for Samsung ou LG?

Como não têm ADB, o CleanYourTV não funciona. O que podes fazer é desligar o rastreio nas definições. Os nomes e os menus variam com o modelo e a versão, por isso usa isto como ponto de partida:

• Samsung: em Definições, Todas as definições, Geral e Privacidade, Termos e Privacidade, desliga «Viewing Information Services» (o ACR da Samsung) e a publicidade baseada em interesses.
• LG: em Definições, Geral, Sistema, Definições adicionais, desliga o «Live Plus» (o ACR da LG) e ativa «Limitar rastreio de anúncios». Na mesma zona, as definições do ecrã inicial permitem desligar banners e recomendações.
• Roku: em Definições, Privacidade, Smart TV Experience, desmarca «Usar informações das entradas da TV».
• Sony (Google TV): em Definições, Privacidade, desliga «Utilização e diagnósticos» e o Samba Interactive TV, se existir.

Mas lembra-te do estudo que referi: desligar as opções nem sempre trava todo o tráfego. A solução mais limpa para quem tem uma TV sem ADB é ligar à TV um streamer externo com Google TV ou Android TV e usá-lo como ecrã inicial, deixando a TV como simples ecrã. Esse streamer pode ser limpo com o projeto, e alguns servem também de centro de casa inteligente.

• Google TV Streamer 4K: Google TV com porta Ethernet e 32 GB. Segundo as análises, serve também como hub Matter, sem precisar de outro equipamento. Para o limpar, o projeto usa a depuração sem fios com código de emparelhamento e tem um guia próprio.
• NVIDIA Shield TV Pro: a opção Android TV mais potente, com 3 GB de RAM e 16 GB de armazenamento, mas bastante mais cara. Confirma a disponibilidade, porque nem sempre há stock.
• Xiaomi TV Box S (3.ª geração): a alternativa económica com Google TV.
• Apple TV 4K: se vives no ecossistema Apple e queres o ecrã inicial sem publicidade, já pronto. Não precisa de limpeza, e já falámos do Infuse para a usar como centro multimédia.

Ver preço atual do Google TV Streamer Ver preço atual da NVIDIA Shield Ver preço atual da Xiaomi TV Box S Ver preço atual da Apple TV 4K

Depois da limpeza: ligar a TV ao Home Assistant

Uma TV Android limpa também fica mais previsível para a casa inteligente. O cuidado é perceber o que a limpeza pode partir e qual a integração mais segura.

• Android TV Remote. A integração do Home Assistant para TVs Android e Google TV fala com o serviço Android TV Remote da própria TV, com um emparelhamento por código, e não precisa de ADB. É a opção mais segura depois de fechares a depuração. Convém não desativar esse serviço na lista de limpeza.
• Android Debug Bridge. A integração ADB exige a porta aberta, o que contraria o conselho de segurança acima. Evita, a não ser que saibas porquê.
• Marcas com integração própria. Philips (JointSpace) e Sony Bravia têm integrações no Home Assistant. O projeto inclui uma ferramenta que verifica, antes e depois da limpeza, se a API da Philips que o Home Assistant usa continua a responder. Em qualquer marca, volta a testar a integração depois de aplicar uma lista.
• Chromecast integrado. O projeto diz que se mantém para telemóveis Android, mas em dispositivos Google a desativação do assistente de configuração pode custar o envio a partir do telemóvel. Testa.

Quando a TV estiver no Home Assistant, aparece uma entidade media_player. Se queres mostrá-la no painel, o Episódio 6 explica como. E, se queres saber quanto gasta a TV, as tomadas com medição de consumo ajudam. Com o ecrã limpo, falta organizar o que vês: os guias Jellyfin vs Plex e Emby vs Jellyfin vs Plex ajudam a montar a tua biblioteca.

Duas automatizações para começar. Se ainda não criaste nenhuma, o Episódio 4 mostra o editor visual. Troca os nomes das entidades pelos teus.

Modo cinema quando a TV liga

alias: Modo cinema quando a TV liga
triggers:
  - trigger: state
    entity_id: media_player.tv_sala
    from: "off"
    to: "on"
conditions:
  - condition: sun
    after: sunset
actions:
  - action: light.turn_on
    target:
      entity_id: light.sala
    data:
      brightness_pct: 15

Os estados da TV dependem da integração e do modelo, por isso confirma na entidade como aparece «lIgada». Para controlar as luzes sem neutro, vê o guia do interruptor inteligente sem neutro.

Desligar a TV quando a casa fica vazia

alias: Desligar a TV com a casa vazia
triggers:
  - trigger: numeric_state
    entity_id: zone.home
    below: 1
    for: "00:10:00"
conditions:
  - condition: not
    conditions:
      - condition: state
        entity_id: media_player.tv_sala
        state: "off"
actions:
  - action: media_player.turn_off
    target:
      entity_id: media_player.tv_sala

A zona «casa» conta as pessoas em casa, pela localização do telemóvel, tal como nos guias das válvulas termostáticas e do ar condicionado. Os 10 minutos evitam desligar por uma falha momentânea de localização.

Perguntas frequentes

É seguro? Pode estragar a TV?

O projeto não faz root, não altera o firmware e não apaga nada: desativa pacotes no perfil do utilizador, como o botão «Desativar» das Definições. O risco é desativar algo de que a TV depende, por isso aplica em lotes pequenos e guarda o script de restauro. Se a TV deixar de arrancar, o reset de fábrica costuma resolver.

É legal e perco a garantia?

O projeto só usa opções que a TV oferece ao dono, como a depuração ADB e o comando de desativar pacotes, e diz que não contorna bloqueios nem proteções de cópia. Mudar o software de uma TV pode, mesmo assim, afetar a garantia ou o suporte do fabricante, por isso convém ler as condições da tua marca antes de avançar.

Funciona em TVs Samsung e LG?

Não. As TVs Samsung (Tizen), LG (webOS), Roku, Vizio e Hisense VIDAA não têm ADB, e o CleanYourTV não corre nelas. Podes desligar o rastreio nas definições ou ligar à TV um streamer externo com Google TV ou Android TV, que podes limpar, e usá-lo como ecrã inicial.

Também remove os anúncios dentro das apps?

Só em parte. A limpeza remove os anúncios do ecrã inicial e da TV, mas não os das apps. O projeto sugere o DNS privado do Android (Android 9 ou superior), apontado para um resolvedor que bloqueia anúncios, mas isso não remove os anúncios do YouTube e o resolvedor passa a ver todas as consultas DNS da TV.

Como desfaço a limpeza?

Com o script de restauro e a lista que aplicaste, que repõe o estado gravado antes da mudança. O launcher fica instalado, e podes removê-lo em Definições, Apps. Se não tiveres o computador, a página Definições, Apps da própria TV também permite reativar pacotes um a um.

E agora?

Voltamos à série Home Assistant, com um tema que faz a casa mais fácil de usar: botões e comandos Zigbee para cenas, sem pegar no telemóvel. Vem aí um guia dedicado. Entretanto, volta ao guia completo da série Home Assistant e segue o @netthings no Telegram para não perderes o próximo artigo.