Pular para o conteúdo
>_ViktorKav

Tutorial · TV e personalização

Free My TV: sua TV do seu jeito com IA

Instale uma nova tela inicial, aprenda a voltar à original e use IA para adaptar o visual. Da base pronta do Simba às minhas skins e ao feed pessoal, com cada etapa separada para você escolher até onde quer ir.

Leitura20 min
NívelIniciante
Atualizado25/out/26
Victor ao lado de uma TV personalizada, com ChatGPT e Claude ilustrando o uso de IA.
Ilustração da personalização com IA.
Você pode parar em qualquer etapa depois de conferir o resultado.
01 · conferirSistema e versão
02 · experimentarInstalar e saber voltar
03 · adaptarVisual e feed opcional
SumárioComeço
  1. Escolha o projeto original ou a minha versão
  2. Confira o sistema antes de baixar
  3. Baixe o APK e prepare o computador
  4. Autorize a conexão com a TV
  5. Instale e troque a tela inicial
  6. Saiba voltar ao início original
  7. Explore as skins e o que foi medido
  8. Peça sua primeira mudança para a IA
  9. Monte um feed pessoal, se quiser essa camada
  10. LG e Samsung: caminhos separados
  11. Se alguma etapa não funcionar
  12. Guarde o que funcionou e continue

01

Escolha o projeto original ou a minha versão

Eu queria apertar o botão Início e encontrar os aplicativos que uso, sem uma vitrine de filmes para alugar ocupando a tela. Parti do Free My TV, projeto aberto de Simba (simbasjungles), e usei IA para adaptar o visual e as sugestões de vídeo ao meu jeito.

O programa que organiza essa tela é o launcher. Ele muda a entrada para os seus aplicativos. A publicidade dentro do YouTube e dos outros serviços continua seguindo as regras de cada aplicativo, e filmes pagos continuam pagos.

VersãoCompatibilidadeO que você encontra
Projeto original do SimbaAPK público v1.2: Android 8 ou superior. Também há caminhos próprios para LG e Samsung.A base do launcher, com a configuração e os recursos descritos pelo autor.
Minha versão no GitHubAndroid 12 ou superior. Testei na minha TCL com Android 12.Skins ViktorKav e Apple Liquid Glass, navegação e estrutura para um feed pessoal. O feed precisa de um servidor configurado por você.

Minha versão é um fork: uma cópia que mantém o histórico e os créditos do projeto original e acrescenta minhas mudanças. No GitHub, a branch viktorkav reúne essas adaptações; a main preserva o projeto original.

02

Confira o sistema antes de baixar

Abra Configurações → Sobre ou Informações do sistema na TV. Procure o sistema e a versão: a marca na moldura, sozinha, não responde se o aplicativo funciona.

  • Google TV ou Android TV: é o caminho de instalação por APK deste guia. O sistema também precisa permitir as autorizações de depuração usadas pelo projeto.
  • Minha versão: Android 12 em diante. A versão mínima é um filtro, não uma garantia de funcionamento em todo aparelho.
  • LG/webOS ou Samsung/Tizen: use os guias específicos no final. O APK Android não serve nesses sistemas.
  • Aparelho externo por HDMI: a alteração acontece no streamer Android TV/Google TV. A interface interna da televisão continua separada.

A TCL testada se identifica como “Smart TV Pro” no Android. Essa identificação não informa o modelo comercial nem o tamanho da tela. Não use o meu teste como confirmação para uma linha inteira de TVs.

O que separar

  • TV compatível e computador Windows, macOS ou Linux, na mesma rede de casa.
  • Controle da TV para aceitar autorizações e testar a navegação.
  • APK escolhido e Android SDK Platform Tools, baixados das fontes abaixo.
  • Uma foto da tela inicial original e um registro das configurações, antes da troca.

O código é aberto e o APK é gratuito. Se optar por usar um agente de IA, valem o plano e os limites da sua conta. O feed avançado também pede um equipamento ligado para servir os dados.

03

Baixe o APK e prepare o computador

Escolha uma versão. Você não precisa instalar as duas:

O APK de distribuição usa configurações neutras, sem o meu servidor. Foi compilado e verificado, mas não foi reinstalado na TV para esta publicação.

As skins pessoais não vêm no APK original. O APK do meu fork também não entrega automaticamente as inscrições de uma conta do YouTube: o serviço de feed é uma configuração separada. Neste fork, não há fallback de sugestões por TMDB.

1

Baixe o Platform Tools

Abra a página oficial de Android SDK Platform Tools, escolha o ZIP do seu computador e extraia. Essa pasta contém o ADB, a ferramenta que conecta o computador ao Android.

2

Junte os arquivos

Coloque o APK escolhido na pasta platform-tools. Os comandos abaixo usam o nome FreeMyTV.apk; confira o nome do arquivo que você baixou e ajuste se necessário.

3

Abra o terminal nessa pasta

No Windows, use PowerShell. No macOS e no Linux, use o Terminal. Você pode abrir a pasta pelo terminal com cd "caminho completo da pasta platform-tools", substituindo o caminho pelo local em que extraiu os arquivos.

04

Autorize a conexão com a TV

1

Ative as opções de desenvolvedor

Na TV, abra Configurações → Sistema → Sobre. Pressione sete vezes o item da compilação do Android TV. Volte, abra as opções de desenvolvedor e ative Depuração USB. Os nomes dos menus variam por fabricante.

2

Anote o IP da TV

Em Rede e Internet, abra os detalhes da conexão. O endereço IP identifica a TV na rede. Na minha TCL, a conexão funcionou por rede mesmo com a opção se chamando Depuração USB.

Nos exemplos deste guia, 192.168.1.50 é apenas um endereço fictício. Substitua pelo IP da sua TV. Execute o bloco correspondente ao sistema do computador:

Windows / PowerShell: conectar
.\adb.exe connect 192.168.1.50:5555
macOS / Linux: conectar
./adb connect 192.168.1.50:5555

Se a TV pedir autorização, confira se é a conexão que você acabou de iniciar e aceite pelo controle. Depois confira os dispositivos:

Windows / PowerShell: conferir
.\adb.exe devices
macOS / Linux: conferir
./adb devices

O endereço da TV deve aparecer acompanhado de device. unauthorized significa autorização pendente; offline indica conexão indisponível. Resolva esse estado antes de instalar.

05

Instale e troque a tela inicial

Com a TV autorizada e identificada como device, envie o APK. O parâmetro -s escolhe o aparelho e evita instalar em outro Android conectado:

Windows / PowerShell: instalar
.\adb.exe -s 192.168.1.50:5555 install -r FreeMyTV.apk
macOS / Linux: instalar
./adb -s 192.168.1.50:5555 install -r FreeMyTV.apk

Success confirma a instalação. Se aparecer erro, leia a mensagem antes de continuar. Se o sistema bloquear o arquivo, confira a origem e o aviso mostrado pelo aparelho.

Desconecte o computador antes de ativar a home

O aplicativo faz a própria conexão de depuração para trocar o início. O projeto original documenta que, em Android 8–10, a autorização pode ir para o computador se ele continuar conectado.

Windows / PowerShell: desconectar
.\adb.exe disconnect 192.168.1.50:5555
macOS / Linux: desconectar
./adb disconnect 192.168.1.50:5555
1

Abra Free My TV

Na lista de aplicativos da TV, abra Free My TV. Entre em Início / Home Screen → Free My TV. Se aparecer uma nova autorização de depuração, confira e aceite: agora é a conexão do aplicativo.

2

Teste com o controle

Aperte Início, navegue pelas setas, abra um aplicativo e volte. Confira volume, entradas HDMI, atalhos, suspensão e retorno. Alguns botões de aplicativos dependem do launcher original e podem mudar de comportamento quando ele é desativado.

Particularidade da minha TCL

No meu aparelho, foi necessário liberar a execução em segundo plano. Se a troca não começar, confira a permissão e as autorizações. Depois de reconectar pelo ADB e confirmar o destino, o comando usado foi:

TCL: liberar auto-início (macOS / Linux)
./adb -s 192.168.1.50:5555 shell appops set io.freemytv AUTO_START allow

No PowerShell, substitua ./adb por .\adb.exe. Em seguida, desconecte o computador novamente e repita a troca pelo controle. Esse ajuste é uma particularidade do aparelho testado, não um passo universal para qualquer marca.

06

Saiba voltar ao início original

Antes de personalizar mais, localize Free My TV → Início / Home Screen → Original. Faça uma volta de teste e confirme que a home original e as funções que você usa continuam acessíveis.

  • Pressione Início e confira a tela original.
  • Abra seus aplicativos principais e volte.
  • Teste volume, controle, entradas e tela de descanso.
  • Se quiser continuar usando o launcher, selecione Free My TV novamente.

Para remover o programa, volte ao Original primeiro e só depois desinstale pelas configurações da TV. A restauração usa o estado registrado pelo projeto; não equivale a um backup integral do aparelho.

Se a volta não funcionar, preserve os registros e consulte as instruções do projeto para o seu aparelho. Confira se a autorização do ADB e a execução em segundo plano continuam disponíveis. Não saia desativando ou reativando pacotes desconhecidos só pelo nome.

07

Explore as skins e o que foi medido

No meu fork, abra as configurações e alterne entre ViktorKav e Apple Liquid Glass. A primeira usa grafite e ciano; a segunda explora transparência e um visual claro. As telas de descanso também acompanham a proposta da skin.

Depois de trocar, confira se os nomes são legíveis do sofá e se o foco das setas aparece tanto em imagens claras quanto escuras. Transparência bonita numa captura pode atrapalhar o uso na TV.

Menos memória, sem promessa de velocidade

Na rodada filmada da minha TCL, a memória atribuída ao início caiu de 221 para 123 MB. A memória disponível para o sistema passou de 860 para 935 MB. São medidas diferentes: a primeira olha o conjunto de processos da home; a segunda, o espaço disponível informado pelo sistema.

O teste do botão Início marcou 66 ms no original e 78 ms no Free My TV. Portanto, essa rodada mostrou menor uso de memória, mas não demonstrou abertura mais rápida. Use os números como resultado desse aparelho e dessa medição.

08

Peça sua primeira mudança para a IA

Para ir além do APK pronto, use um agente que trabalhe nos arquivos do computador, como Codex ou Claude Code. Instale pela fonte oficial, entre na sua conta e selecione uma pasta local para o projeto. Peça primeiro para conferir o caminho e o que já existe nela.

Escolha de onde partir: simbasjungles/free-my-tv para a base original ou viktorkav/free-my-tv para minhas adaptações. Neste segundo caso, use a branch viktorkav. O pedido abaixo já aponta para ela:

Pedido copiável: primeira alteração
Quero adaptar https://github.com/viktorkav/free-my-tv, branch viktorkav.
Use a pasta local que selecionei e confira seu caminho antes de começar.
Minha TV é [marca/modelo], usa [sistema e versão] e está na mesma rede.
Hoje o que me incomoda é [uso concreto].
Minha primeira mudança será [uma alteração observável].

Leia o README e explique o que precisa mudar. Preserve a licença e os
créditos do projeto original. Prepare o ambiente de compilação, registre
o estado atual e proponha um teste com o controle.

Antes de instalar, confira a assinatura do app que já está na TV.
Se for diferente, explique a migração com retorno ao Original e
preservação das configurações. Mostre como voltar e espere minha
confirmação antes de modificar o aparelho.

Exemplo de objetivo: “Uso YouTube, Jellyfin e Globoplay. Quero esses três apps em destaque, letras maiores e um foco que eu consiga distinguir do sofá”. É um pedido que você consegue conferir depois.

Use uma referência visual e corrija pelo uso

Pedido copiável: visual e legibilidade
Use esta imagem como referência de cores e tipografia.
A interface aparece numa TV e é navegada pelas setas do controle.
Quero ler os nomes e reconhecer o item selecionado do sofá.
Mostre uma proposta antes de implementar e preserve o funcionamento.

Se o cartão cobrir demais o fundo, aumente a transparência sem perder
legibilidade. Confira foco, abertura dos apps, retorno e descanso em
imagens claras e escuras.

Compilar e manter suas próximas atualizações

O fork usa build.sh. O ambiente exige JDK 17 ou superior e ferramentas do Android SDK, incluindo build-tools e uma plataforma Android compatível. O README do fork descreve os requisitos e a configuração atual. No Windows, a compilação usa um ambiente compatível, como WSL; a instalação de um APK pronto pelo PowerShell continua sendo a rota mais simples.

Compilar transforma o código em um APK. O arquivo config.properties guarda opções locais; a chave freemytv.keystore assina suas atualizações. Preserve sua chave e mantenha configuração, tokens e credenciais fora do Git. Uma instalação própria passa a ter uma assinatura diferente da release pública.

09

Monte um feed pessoal, se quiser essa camada

As sugestões que aparecem na minha TV vêm de um serviço separado no meu ZimaBoard. Ele consulta publicações recentes dos canais da conta autorizada e entrega dados e imagens para o launcher pela rede local. Esse programa é um servidor.

Instalar o APK não configura esse serviço. Você precisa preparar seu próprio servidor, configurar a API do YouTube, autorizar a conta e informar os endereços esperados pela sua cópia do aplicativo. As referências e dados de canal do fork continuam personalizados para o ViktorKav; revise-os para o seu uso.

  1. Leia o guia do feed pessoal e o código do fork antes de escolher onde executá-lo.
  2. Prepare um serviço na sua rede e configure o projeto da API do YouTube.
  3. Autorize somente as permissões necessárias. OAuth é o consentimento que permite ao serviço consultar os dados da conta.
  4. Mantenha tokens, segredos e arquivos de autorização no servidor, fora do APK e do repositório.
  5. Configure na sua cópia a URL do serviço e o acesso de rede correspondente. Não use os endereços de outra casa.
  6. Teste o retorno quando o servidor estiver fora do ar, além da navegação normal.

Na versão demonstrada, aparecem três cards grandes por grupo. A seta para a direita após o terceiro busca o próximo grupo; a esquerda permite voltar. O catálogo é finito e depende das publicações consultadas, das cotas e da autorização. Ele não reproduz o ranking da página inicial do YouTube nem garante todo o histórico de cada inscrição.

O filtro pessoal procura omitir Shorts e resultados cuja classificação não consegue confirmar. A API não fornece um campo universal isShort para resolver isso sozinha. O projeto também não elimina publicidade de dentro do aplicativo YouTube.

10

LG e Samsung: caminhos separados

Esses caminhos pertencem ao projeto original e estão aqui como referência. Eu não testei minha versão em LG ou Samsung. Nessas plataformas, o Free My TV abre como um aplicativo e a home original continua existindo. A troca de launcher e a limpeza do Android não se transferem automaticamente.

LG com webOS

O original declara webOS 3 ou mais recente. Você precisa do aplicativo Developer Mode, de uma conta de desenvolvedor LG e do computador na mesma rede.

  1. Instale Developer Mode pela LG Content Store e entre na sua conta.
  2. Ative Dev Mode Status, reinicie e ligue Key Server. Anote IP e passphrase exibidos na TV.
  3. No computador, prepare Python 3 e uma cópia do projeto original. Use o instalador webOS próprio, não o APK Android.
Original: compilar e instalar para webOS
python3 webos/build.py
python3 webos/install.py 192.168.1.50

Substitua o IP pelo da LG. Digite pessoalmente a passphrase quando o instalador pedir. Abra Free My TV pela lista de aplicativos. Renove a sessão no Developer Mode com EXTEND antes de expirar; a LG informa que desativar esse modo remove os aplicativos instalados por ele.

Consulte o guia webOS da versão citada e a documentação oficial da LG.

Samsung com Tizen

O original indica modelos de 2017 em diante, com Tizen 3 ou superior, e usa o instalador comunitário TizenBrew.

  1. Na área Apps / Apps Settings, digite 12345 pelo controle ou teclado numérico para abrir as configurações de desenvolvedor.
  2. Ative Developer mode. Em Host PC IP, informe o endereço do computador e reinicie a TV.
  3. No computador, abra o TizenBrew Installer e conecte ao endereço da TV.
  4. Na instalação a partir do GitHub, informe simbasjungles/free-my-tv.
  5. Se o aparelho exigir login Samsung para assinar o aplicativo, faça a autenticação pessoalmente na interface indicada.

Abra pela lista de apps. A opção Autorun Last App, quando disponível, pode abrir o último aplicativo ao ligar, mas não substitui a home Samsung. Confira as instruções do projeto e o guia oficial de Developer Mode.

11

Se alguma etapa não funcionar

SintomaO que conferir primeiro
O ADB não conectaIP atual, mesma rede, depuração, autorização no controle e método de pareamento do modelo.
Aparece unauthorizedAceite a conexão correta na TV. Confira novamente com adb devices.
O APK não instala como atualizaçãoVersão mínima do Android e assinatura do app. Para trocar assinaturas, volte ao Original antes de remover a versão anterior.
Início não mudaAutorização do próprio app, ADB do computador desconectado e permissão de segundo plano. Na TCL testada, conferir AUTO_START.
Um atalho do controle parouTeste o modo Original. Alguns atalhos dependem do launcher do fabricante.
Os cards do feed não carregamServidor próprio em execução, URL configurada, acesso pela rede, OAuth válido e cotas da API.
A mudança não ficou boaVolte à versão que funcionava e peça uma correção por vez. Teste legibilidade, foco e retorno na TV.

Ao pedir ajuda, informe sistema, versão, etapa e a mensagem de erro completa. Remova tokens, códigos de autorização e outros dados privados do que vai compartilhar. Para instalação, a documentação de ADB do Android é a referência da ferramenta.

12

Guarde o que funcionou e continue

Escolha uma primeira melhoria pequena, confira na televisão e guarde uma versão que funciona. Registre o pedido, os arquivos modificados, a versão instalada e como voltar. Esse histórico facilita a próxima mudança muito mais do que tentar lembrar tudo de cabeça.

As instruções da versão original aqui se referem à release v1.2.0. Meu teste foi na TCL com Android 12 e no fork com skins e feed pessoal. Confira as notas da versão que você baixar antes de executar os passos.