Início
» KODI
»
Kodi não está funcionando? 5 causas comuns e o que verificar primeiro
Kodi não está funcionando? 5 causas comuns e o que verificar primeiro
Se o Kodi não estiver funcionando, primeiro identifique a causa do problema: o próprio aplicativo, um complemento, uma fonte online ou um vídeo específico. Feche e abra o Kodi novamente e reinicie o dispositivo. Em seguida, teste um arquivo de mídia local e compare-o com o complemento ou a localização de rede que está apresentando problemas. Essa comparação rápida geralmente indica a causa correta antes que você precise alterar as configurações ou apagar os dados.
O Kodi não abre ou trava constantemente: verifique a versão instalada, o espaço de armazenamento livre e as alterações recentes de temas ou complementos.
Apenas um complemento apresentou falha: verifique suas atualizações, dependências, repositório e status do serviço.
O vídeo online carrega lentamente, mas os arquivos locais são reproduzidos: investigue a rede ou a fonte remota.
O vídeo local também apresenta travamentos: verifique a capacidade do dispositivo, o formato do arquivo e as configurações de reprodução.
1. O Kodi ou um complemento está desatualizado.
Uma versão mais recente do Kodi pode corrigir erros, mas os complementos podem ficar desatualizados. Verifique Configurações > Informações do sistema para obter informações sobre sua versão e plataforma. Para uma instalação estável, use a versão estável oferecida pelo Kodi ou pela loja de aplicativos confiável onde você o instalou. Em 24 de outubro de 2026, a versão estável mais recente nas notas do Kodi era a 21.3 “Omega”; o Kodi 22 “Piers” ainda estava rotulado como Release Candidate 1 em 10 de outubro, uma versão de teste que pode conter erros não resolvidos.
A área de informações do sistema do Kodi agrupa detalhes como versão, armazenamento, rede, vídeo e hardware.
2. Um complemento ou repositório está com problemas.
Se a tela inicial do Kodi funcionar, mas um complemento falhar, suspeite do servidor, de uma dependência ausente ou de um problema de compatibilidade. No gerenciador de complementos, verifique " Meus complementos" e "Atualizações disponíveis" e atualize o complemento a partir do repositório. Se a falha ocorreu após uma alteração, desative temporariamente o complemento ou tema e teste novamente.
A equipe do Kodi mantém o repositório integrado do Kodi. Para complementos ZIP ou de terceiros, você deve verificar a compatibilidade por conta própria; o Kodi alerta que complementos desconhecidos podem acessar dados do dispositivo. Remova repositórios nos quais você não confia mais e evite ferramentas de "reparo" não verificadas. Consulte o guia do gerenciador de complementos e a documentação oficial do repositório .
O navegador de complementos permite inspecionar os itens instalados e as atualizações disponíveis.
3. A rede ou fonte de mídia está indisponível.
O Kodi é um software de central multimídia, não o serviço remoto por trás de cada complemento. Se um vídeo local for reproduzido, mas um streaming online, compartilhamento de rede ou caminho da biblioteca não, verifique a conexão com a internet, a acessibilidade do NAS ou computador, o caminho da pasta e as credenciais salvas. Teste a fonte em outro dispositivo; se também falhar lá, pode ser que o serviço esteja fora do ar. Aguarde antes de reinstalar o Kodi.
O buffering não é necessariamente um problema de cache. O Kodi afirma que alterações no cache não aceleram um servidor lento ou sobrecarregado, e "zerar o cache" não melhora a reprodução. Verifique os detalhes da sua rede, teste outra fonte à qual você tenha autorização de acesso e consulte o guia de cache do Kodi .
4. O espaço de armazenamento é insuficiente ou o dispositivo não consegue decodificar o vídeo.
Pouco espaço livre pode bloquear atualizações ou impedir o download de complementos e imagens. Verifique Configurações > Informações do sistema > Armazenamento e libere espaço através do sistema operacional do dispositivo ou remova complementos e downloads não utilizados. Imagens e alguns complementos podem acumular dados; não exclua pastas aleatoriamente nem execute um programa não oficial de limpeza de cache.
Se o vídeo em alta resolução apresentar travamentos, congelamentos ou exibir uma imagem em branco, o dispositivo pode não ser compatível com o codec ou o caminho de decodificação de hardware desse arquivo. Compare-o com um arquivo local de resolução mais baixa e verifique as configurações de reprodução do Kodi. Altere uma configuração avançada por vez e reverta-a se a imagem piorar. Consulte o guia de configurações de reprodução de vídeo do Kodi .
5. Uma skin, perfil ou configuração está corrompida.
Travamentos após a instalação de uma nova versão, troca de temas ou adição de extensões podem ser causados por configurações conflitantes. Alterne para o tema padrão Estuary, desative os complementos recentes um de cada vez e teste. O Kodi recomenda isolar a causa removendo temporariamente os dados do usuário ou um complemento.
Faça backup da pasta de dados do Kodi antes de uma inicialização limpa ou reinstalação. A redefinição dos dados do usuário remove configurações, complementos, bancos de dados e entradas da biblioteca, embora os arquivos de mídia armazenados em outros locais permaneçam. Um backup completo pode reintroduzir a configuração com problema, portanto, restaure seletivamente se o problema retornar. Siga o guia de backup específico da plataforma Kodi antes de remover os dados.
Quando a causa ainda não está clara.
Ative o registro de depuração, reproduza o problema uma vez e verifique o registro em busca do primeiro erro relevante. Isso pode ajudar a separar falhas de inicialização, de complementos, de reprodução e de rede. Se você compartilhar isso com a comunidade Kodi, siga as orientações do fórum e evite expor informações pessoais. Use as instruções oficiais de registro de depuração .
Uma sobreposição de depuração pode exibir detalhes de reprodução e do sistema; o registro captura o erro real do seu dispositivo.
Use primeiro as verificações menos disruptivas: reinicie, isole o complemento ou a fonte, atualize a partir de um canal oficial, verifique a compatibilidade de armazenamento e reprodução e teste um perfil limpo somente após fazer um backup.