O jeito mais rápido
Abra o TS Launcher TV → Configurações → Definir como tela inicial. O app identifica o seu aparelho e mostra o método certo. Quando o TS Launcher TV já for a tela inicial, o botão “Definir como padrão” some automaticamente.
Passo 0 — Escolha o método ideal para o seu aparelho
| Seu aparelho | Método recomendado (em ordem) |
|---|---|
| TV box Android comum (X96, H96, Tanix, boxes Amlogic/Rockchip/Allwinner…) | D (escolha “Sempre”) → A |
| Android TV mais antiga (Sony/Philips/Sharp/TCL anteriores a 2021, Mi Box S, Mi TV Stick, FPT Play Box, Shield) | A (se o menu existir) → B → C |
| Google TV (Chromecast with Google TV, Google TV Streamer, Google TVs Sony/TCL/Xiaomi/Coocaa/Casper/Philips) | B (fácil, pode parar após atualizações) → C (o mais estável) |
| TV Xiaomi com PatchWall | Desative o PatchWall no menu da TV → B → C |
| TV com o TS Launcher TV pré-instalado de fábrica | Já é o padrão, não é preciso fazer nada |
| Amazon Fire TV | Não pode ser definido como tela inicial (o Fire OS bloqueia launchers de terceiros); abre apenas como um app comum |
AEscolher nas Configurações da TV
O mais rápido se o seu aparelho tiver a opção de escolher o app de tela inicial (comum em TV boxes e em algumas Android TVs).
- 1Aperte o botão Configurações (engrenagem) no controle remoto ou selecione o ícone de engrenagem no canto superior direito.
- 2Acesse Apps → Apps padrão (Default apps) → App de tela inicial (Home app). Em alguns aparelhos: Preferências do dispositivo (Device Preferences) → Apps → Tela inicial.
- 3Selecione TS Launcher TV.
- 4Aperte HOME no controle remoto para conferir.
Não encontrou a opção “Tela inicial / Home app”? O aparelho não é compatível com o método A: passe para o método B ou C.
BAtivar o serviço de Acessibilidade “TS Home Button”
Não precisa de computador. O serviço detecta quando você aperta HOME (ou quando a tela inicial padrão aparece) e abre o TS Launcher TV na hora. O launcher original continua no aparelho, então às vezes ele pode “piscar” por menos de 1 segundo.
Privacidade do TS Home Button
O serviço é usado apenas para: detectar o botão HOME e abrir o TS Launcher TV; (opcional) direcionar o botão do microfone do controle para o TS Assistant; (opcional) executar ações de navegação/digitação quando você usa o TS Remote. O TS Launcher TV não lê, não armazena nem envia o conteúdo da tela. Antes de ativar, você verá uma tela explicativa pedindo o seu consentimento. Detalhes na Política de Privacidade.
B1. Ativar pelo app (recomendado)
- 1Abra TS Launcher TV → Definir como tela inicial → leia o aviso → Concordar e abrir Configurações.
- 2A TV abre a tela de Acessibilidade. Selecione TS Home Button (em alguns aparelhos aparece como TS Launcher TV) → ative Ativado/On → OK/Permitir.
- 3Aperte Voltar e depois HOME para testar.
B2. Ativar manualmente, por fabricante
| Fabricante / sistema | Caminho |
|---|---|
| Google TV (Chromecast, Streamer, Sony/TCL/Xiaomi/Coocaa/Casper) | Configurações → Sistema (System) → Acessibilidade (Accessibility) → TS Home Button → Ativar |
| Android TV mais antiga (Sony, Philips, Sharp, TCL, Mi Box S, FPT Play Box) | Configurações → Preferências do dispositivo → Acessibilidade → TS Home Button → Ativar |
| TCL Google TV | Configurações → Sistema → Acessibilidade → Serviços → TS Home Button |
| Xiaomi (PatchWall / Android TV) | Configurações → Preferências do dispositivo → Acessibilidade → TS Home Button |
B3. Botão Ativar esmaecido / aviso de “Configuração restrita”
Acontece no Android 13 ou superior quando o app é instalado por arquivo APK (a versão baixada do Google Play não tem esse problema).
- Acesse Configurações → Apps → TS Launcher TV.
- Procure a opção Permitir configurações restritas (Allow restricted settings), geralmente no menu ⋮ ou no fim da página, e confirme.
- Volte ao passo B1.
- Se a TV não tiver essa opção, use o comando
appopsdo Método C, passo 4.
B4. Observações sobre o método B
- Algumas atualizações de software da TV podem fazer este método parar de funcionar ou desativar a Acessibilidade automaticamente. Essa é uma limitação comum a todos os launchers que usam o mecanismo de Acessibilidade. Se isso acontecer, use o Método C.
- Ative a Acessibilidade para apenas UM launcher. Se outro launcher também estiver ativado, o botão HOME vai “pular” entre os dois apps.
- Se travar ao sair/entrar na Conta do Google na TV, desative temporariamente o TS Home Button e ative de novo depois.
CUsando ADB — o mais estável para Google TV
Desativa (disable) temporariamente o launcher original para o usuário atual. Nada é apagado, não precisa de root e tudo pode ser desfeito com um único comando.
C1. Ativar as Opções do desenvolvedor na TV
- 1Google TV: Configurações → Sistema → Sobre (About) → Build do SO Android TV → aperte OK 7 vezes até aparecer “Você agora é um desenvolvedor”.
Android TV mais antiga: Configurações → Preferências do dispositivo → Sobre → Build → aperte OK 7 vezes. - 2Acesse Sistema / Preferências do dispositivo → Opções do desenvolvedor e ative a Depuração USB. Se houver, ative também a Depuração por Wi-Fi (Wireless debugging) (Android TV 11+ / Google TV 12+) ou a Depuração ADB pela rede em alguns boxes.
- 3Anote o endereço IP da TV: Configurações → Rede e Internet → (nome do Wi-Fi).
C2. Conectar via ADB
Pelo celular (sem computador): use um app de ADB do Google Play (por exemplo, um app com a aba “Shell”), digite o IP da TV (porta 5555, ou a porta e o código de pareamento exibidos em Depuração por Wi-Fi → Parear dispositivo com código de pareamento), aceite na TV e digite os comandos do C3 (sem o adb shell do início).
Pelo computador (Windows/macOS/Linux): baixe o Android SDK Platform-Tools no site developer.android.com, descompacte e abra o Terminal/Prompt de Comando nessa pasta.
adb connect 192.168.1.50:5555 # substitua pelo IP da TVadb devices # deve aparecer "device"adb pair 192.168.1.50:37123 # porta + código de 6 dígitos exibidos na TVadb connect 192.168.1.50:41234 # porta da tela Depuração por Wi-FiNa TV, selecione Sempre permitir a partir deste computador → OK. Se adb devices mostrar unauthorized, olhe para a TV e aceite a caixa de diálogo.
C3. Comandos
Importante
Instale e abra o TS Launcher TV pelo menos 1 vez ANTES de desativar o launcher original; caso contrário, a tela pode ficar preta. Nome do pacote: tss.t.tslauncher.tv (versão TV) ou tss.t.tslauncher.tv.tvbox (versão TV Box); confira em TS Launcher TV › Configurações › Informações. Os comandos abaixo usam a versão TV; se você usa a versão TV Box, troque pelo nome de pacote correspondente.
Passo 1 — Veja qual é o launcher atual:
adb shell cmd package resolve-activity --brief -a android.intent.action.MAIN -c android.intent.category.HOMEPasso 2 — Tente o jeito mais leve (só define como padrão, sem desativar nada):
adb shell cmd package set-home-activity tss.t.tslauncher.tv/tss.t.tslauncher.tv.ui.main.MainActivityAperte HOME. Se abrir o TS Launcher TV e continuar assim depois de reiniciar a TV, pronto. No Google TV, isso geralmente não basta: siga para o passo 3.
Passo 3 — Desative o launcher original (execute um comando de cada vez):
adb shell pm disable-user --user 0 com.google.android.apps.tv.launcherxadb shell pm disable-user --user 0 com.google.android.tungsten.setupwraithadb shell pm disable-user --user 0 com.google.android.tvlauncheradb shell pm disable-user --user 0 com.google.android.leanbacklauncheradb shell pm disable-user --user 0 com.mitv.tvhome.atvA tela pode ficar preta por alguns segundos → aperte HOME → escolha o TS Launcher TV (se perguntado, escolha Sempre) → reinicie a TV. Para outras TVs/boxes, use o nome do pacote que apareceu no passo 1.
Passo 4 (opcional) — permita que o TS Launcher TV reative a Acessibilidade quando ela for desativada:
adb shell pm grant tss.t.tslauncher.tv android.permission.WRITE_SECURE_SETTINGSadb shell appops set tss.t.tslauncher.tv ACCESS_RESTRICTED_SETTINGS allow # Android 13+, versão instalada por APKNÃO desative os seguintes pacotes
com.android.tv.settings, com.google.android.tv.remote.service, com.tcl.tv, com.tcl.tvinput, com.tcl.suspension, com.sony.dtv.*, com.hisilicon.*, com.mediatek.*, Play Store, Google Play Services: isso vai quebrar o controle remoto, as entradas ou as configurações. Não use pm uninstall em pacotes do sistema.
C4. Observações depois do método C
- Os botões de YouTube/Netflix do controle remoto podem parar de funcionar em alguns aparelhos, porque são tratados pelo launcher original. O TS Launcher TV tenta capturar essas teclas quando o TS Home Button está ativado.
- O Modo ambiente / protetor de tela do Google pode deixar de existir: escolha outro protetor de tela em Configurações → Sistema → Protetor de tela.
- As recomendações de conteúdo e o “Continuar assistindo” do Google TV fazem parte do launcher original e deixarão de aparecer. O TS Launcher TV mostra o Watch Next dos apps compatíveis.
- Atualizações de software da TV (OTA) às vezes reativam o launcher original → execute o passo 3 novamente.
- A restauração de fábrica (factory reset) reativa tudo automaticamente; depois disso, refaça este guia.
DTV box Android: escolha “Sempre”
- 1Instale o TS Launcher TV (versão TV Box).
- 2Aperte HOME no controle remoto.
- 3Quando aparecer o painel “Escolher app de tela inicial” → selecione TS Launcher TV → Sempre (Always).
- 4Escolheu “Apenas uma vez” sem querer ou marcou outro launcher como “Sempre”? Acesse Configurações → Apps → (launcher antigo) → Limpar padrões (Clear defaults) e aperte HOME de novo.
- 5O box não mostra o painel de escolha? Alguns boxes têm Configurações → Outros/Avançado → Launcher padrão; se não houver, use o Método C com o nome do pacote que apareceu no passo 1.
Dicas por fabricante
Sony BRAVIA
As Google TVs e Android TVs da Sony geralmente não têm a opção de escolher a tela inicial nas Configurações. Use o Método B (Configurações → Sistema → Acessibilidade → TS Home Button). Para mais estabilidade, use o Método C. Não desative os pacotes com.sony.dtv.*.
TCL
Nas TCL Google TV, o caminho da Acessibilidade é Configurações → Sistema → Acessibilidade → Serviços. Alguns firmwares novos podem deixar o Método B instável; nesse caso, use o Método C. Nunca desative com.tcl.* (o botão Inputs e as entradas dependem desses pacotes).
Xiaomi (Mi TV, Mi Box S, TV Box S, TV Stick)
O Mi Box S e o TV Stick usam o launcher original do Android TV → Método B ou C (com.google.android.tvlauncher). TVs Xiaomi com PatchWall: primeiro desative o PatchWall no menu da TV e depois use B ou C (adicione com.mitv.tvhome.atv). O Xiaomi TV Box S de 2ª geração roda Google TV → use os comandos de Google TV.
Chromecast with Google TV / Google TV Streamer
Não há opção de escolher a tela inicial. Use o Método B ou C. O Google TV Streamer precisa ser pareado pela Depuração por Wi-Fi (adb pair) antes do adb connect. Desative tanto launcherx quanto setupwraith para não ser levado à tela de configuração inicial.
TV boxes Amlogic / Rockchip / Allwinner (X96, H96, Tanix…)
A maioria usa Android puro (AOSP), então ao apertar HOME aparece o painel de escolha → Método D. Alguns boxes já têm Configurações → Apps → Apps padrão → Tela inicial (Método A). Boxes com 1 GB de RAM: o TS Launcher TV ativa o modo Lite automaticamente.
Boxes de operadoras (VNPT, Viettel…)
Geralmente o Método B funciona, mas as atualizações da operadora podem trazer de volta o launcher original. Ainda não testamos o suficiente em todos os modelos de boxes de operadoras.
| Aparelho | A | B | C | D |
|---|---|---|---|---|
| Chromecast with Google TV / Google TV Streamer | ✗ | ✓ | ✓✓ | ✗ |
| Sony BRAVIA Google TV | ✗ | ✓ | ✓✓ | ✗ |
| TCL Google TV | ✗ | ✓ / ✗ conforme o firmware | ✓✓ | ✗ |
| Xiaomi Google TV / TV Box S | ✗ | ✓ | ✓✓ | ✗ |
| Xiaomi PatchWall | Desativar o PatchWall | ✓ | ✓✓ | ✗ |
| Android TV mais antiga (Mi Box S, Shield…) | Alguns aparelhos | ✓ | ✓✓ | Às vezes |
| Boxes de operadoras (VNPT, Viettel) | ? | ✓ ? | ✓ ? | ? |
| Boxes AOSP (X96, H96, Tanix…) | Alguns aparelhos | Não é preciso | ✓ | ✓✓ |
| Amazon Fire TV | ✗ | ✗ | ✗ | ✗ |
Solução de problemas
| Problema | Como resolver |
|---|---|
| Ao apertar HOME, ainda abre o Google TV | Abra o TS Launcher TV → Definir como tela inicial (o app faz a verificação). Desative e ative de novo o TS Home Button. Desative a Acessibilidade de outros launchers. Continua? → Método C. |
| O Google TV “pisca” antes de abrir o TS Launcher TV | É normal no Método B. Use o Método C para acabar de vez com isso. |
| Ao ligar a TV, ainda aparece o Google TV | O Método B só reage a eventos de tela; alguns firmwares os ignoram → use o Método C. |
| Depois de atualizar a TV, voltou a tela antiga | A atualização reativou o pacote desativado → execute de novo o Método C, passo 3. |
| Tela preta depois de desativar | Aperte HOME e escolha o TS Launcher TV com “Sempre”. Continua preta: execute o comando abaixo para abrir o TS Launcher TV; no pior caso → veja Restaurar. |
| O TS Launcher TV abre, mas fica lento/com a interface com erro | O TS Launcher TV muda automaticamente para o modo Lite e, se necessário, para o Safe. Você pode escolher o modo manualmente em Configurações → Desempenho. |
| O botão “Permitir” da Acessibilidade está esmaecido | Configuração restrita (versão APK) → veja a seção B3. |
| Os botões de Netflix/YouTube do controle não funcionam | Ative o TS Home Button para o TS Launcher TV capturar as teclas, use um app de mapeamento de teclas ou restaure o launcher original. |
| O TS Assistant avisa que a TV não tem reconhecimento de voz | Veja o guia de reconhecimento de voz: por que algumas TVs não têm e quais são as alternativas. |
| Não consigo conectar via ADB | Confira se estão na mesma rede Wi-Fi; desative e ative de novo a Depuração USB; aceite a caixa de diálogo na TV; teste um app de ADB no celular. |
| Não aparece o app que acabei de instalar | TS Launcher TV → Todos os apps → atualizar, ou reinicie a TV. |
adb shell am start -n tss.t.tslauncher.tv/tss.t.tslauncher.tv.ui.main.MainActivityRestaurar o launcher original
Se você usou o Método A ou D: Configurações → Apps → Apps padrão → Tela inicial → escolha o launcher original (ou Limpar padrões do TS Launcher TV).
Se você usou o Método B: Configurações → Acessibilidade → TS Home Button → Desativar. O launcher original volta a funcionar na hora.
Se você usou o Método C: execute os comandos abaixo (pelo celular ou computador) e reinicie a TV:
adb shell pm enable com.google.android.apps.tv.launcherxadb shell pm enable com.google.android.tungsten.setupwraithadb shell pm enable com.google.android.tvlauncher # se tiver sido desativadoadb shell pm enable com.mitv.tvhome.atv # Xiaomi PatchWallAntes de desinstalar o TS Launcher TV configurado pelo Método C
Sempre execute primeiro o comando pm enable acima. O TS Launcher TV também mostra esse lembrete quando você escolhe “Desinstalar”.
Sem computador / celular?
- Tente Configurações → Apps → Ver todos os apps → Mostrar apps do sistema → Google TV Home / Android TV Home → Ativar (disponível em alguns aparelhos).
- Último recurso: Restauração de fábrica (Configurações → Sistema → Sobre → Redefinir). Todos os pacotes desativados são reativados, mas os dados da TV serão apagados.
Ainda precisa de ajuda?
Envie o modelo da sua TV/box e uma captura de tela do erro pelo e-mail indicado na seção Contato. Veja também as perguntas frequentes.