
Audita dispositivos Android TV e Google TV via ADB em busca dos malwares BadBox, XCPE e Vo1d, com um sentinela de tráfego VPN, listas de bloqueio de IoC e remediação reversível.
Suite forense, de remoção de malware e de remediação reversível completa e autónoma (CLI + App nativa Android TV com Sentinela VPN) projetada para auditoria, deteção, verificação, neutralização e restauro de trojans de supply-chain, botnets residenciais e malware (BadBox, XCPE, Vo1d, Fuyao, Videostrong/SZBBOYS e Proxyware Residencial) em dispositivos Android TV, Google TV e TV Boxes genéricas.
Idioma: Português (PT-PT) | For English version, see README.md | 📱 Registo de Aparelhos Testados | 🔬 Decisões de Arquitetura (ADRs) | 📜 Avisos de Terceiros
Milhares de Smart TVs e TV Boxes Android económicas chegam ao utilizador pré-infetadas de fábrica ou são comprometidas através de firmwares adulterados e aplicações não oficiais. O malware habitualmente:
package_verifier_user_consent = -1./system ou /vendor (como o Vo1d, BadBox ou XCPE, imunes a reposições de fábrica).Esta ferramenta fornece dois métodos completos para auditar e limpar a sua TV:
audit_security.py) com descoberta de sub-rede, modo JSON puro otimizado para agentes de IA, criação de backup prévio, quarentena de APKs e reversibilidade garantida em backups/.Antes de iniciar ferramentas ou pedir a um Agente de IA para analisar o aparelho, necessita de ativar a Depuração ADB na TV para permitir a ligação via Wi-Fi:
[!WARNING] 🔒 Recomendação Essencial de Segurança (Desativar a Depuração no Fim):
Manter a Depuração USB / ADB permanentemente ativada na sua rede Wi-Fi doméstica deixa aberta a porta de gestão remota (5555), que pode ser sondada por outros aparelhos ou apps maliciosas na rede.
Não se esqueça de voltar a DESLIGAR a Depuração USB nas Opções do Programador assim que terminar o diagnóstico e a limpeza da TV!
Este repositório inclui instruções autónomas completas no ficheiro AGENTS.md que os agentes de IA leem e seguem de forma transparente. Não precisa de configurar Python manualmente, instalar drivers ou escrever comandos.
[!IMPORTANT] 🛡️ Fluxo Operacional Seguro para Agentes de IA:
O agente deve sempre executar primeiro o--quick-scan(diagnóstico 100% de leitura). O plano de remediação e as evidências técnicas encontradas devem ser validados pelo utilizador antes de disparar o--remediate.
Basta abrir o seu Agente de IA favorito e enviar-lhe esta simples instrução:
Faz o clone de https://github.com/Mafarricos/badbox-tv-audit.git, lê o ficheiro AGENTS.md e audita a minha Android TV no IP <IP_DA_TV>.
(Dica: Se não souber o IP da sua TV, diga ao agente: ...lê o AGENTS.md, descobre as Android TVs na minha sub-rede 192.168.1.0/24 e audita-as.)
O agente tratará autonomamente de:
AGENTS.md.community_audit_submission.json) pronto para submissão.app/)A aplicação deteta o idioma da box automaticamente (em Português se a TV estiver em Português; em Inglês para todos os outros idiomas) e é 100% controlável pelo comando (D-Pad):
/oem/, /vendor/, integridade do Play Protect, artefactos de trojans (Vo1d, XCPE) e enumera pacotes instalados em segundos.[CRÍTICO]): Se a box tentar comunicar com IPs ou domínios de servidores C2 conhecidos.[SUSPICIOUS]): Se houver tentativa de ligação a uma porta associada a botnets/proxies sem correspondência direta de IP/domínio C2.[ANOMALIA]): Se houver tráfego anómalo em portas altas enquanto a TV devia estar em repouso.Nota sobre a Ligação à Internet durante a Monitorização: Durante a janela do Sentinela VPN, os pedidos de DNS (UDP porta 53) são inspecionados e reencaminhados (permitindo que a box resolva nomes para detetar domínios C2), mas o restante tráfego TCP/UDP é lido e descartado na interface local. Por esse motivo, enquanto a monitorização estiver ativa, a box fica temporariamente sem navegação aberta, retomando o acesso normal assim que a VPN é desligada.