Início
» KODI
»
Corrigir falhas de inicialização do Kodi: 7 verificações seguras para tentar
Corrigir falhas de inicialização do Kodi: 7 verificações seguras para tentar
Se o Kodi fechar antes de a tela inicial aparecer, reinicie o dispositivo e observe o que mudou imediatamente antes do início das falhas. Em seguida, verifique a versão estável, teste com uma pasta de dados limpa e inspecione o registro de inicialização. Faça backup dos dados do Kodi antes de mover pastas ou reinstalar o programa.
As figuras são ilustrativas; as interfaces do Kodi e as telas do sistema operacional podem variar.
1. Reinicie o Kodi e observe as alterações recentes.
Feche o Kodi completamente, reinicie o dispositivo e tente novamente. No computador, feche aplicativos que estejam consumindo muitos recursos e verifique se há espaço livre em disco. Desconecte temporariamente qualquer dispositivo USB adicionado recentemente ou desconecte um monitor ou cabo de áudio que tenha sido trocado. Observe se o problema começou após uma atualização do Kodi, de um complemento, de um tema, do sistema operacional ou de um driver. Altere uma coisa de cada vez.
A tela inicial de um centro de mídia ilustra onde uma inicialização normal do Kodi deve terminar.
2. Atualize através de um canal oficial.
Instale o Kodi a partir da página oficial de downloads ou da loja de aplicativos da sua plataforma. A partir de 27 de outubro de 2026, a Equipe Kodi classificou o Kodi 22 “Piers” RC 1 como uma versão prévia. Para maior confiabilidade, use a versão estável mais recente disponível para o seu dispositivo; escolha uma versão candidata a lançamento apenas se você pretende testar um software em versão prévia. Reinicie o dispositivo após a atualização e teste o Kodi antes de restaurar os complementos.
Evite instaladores de terceiros e pacotes "inclusos". Os complementos podem se comportar de maneira diferente do próprio Kodi.
Um painel de atualização representa a instalação do Kodi através do canal oficial para o seu dispositivo.
3. Verifique o dispositivo e seus alertas de segurança.
Instale as atualizações pendentes do sistema operacional e verifique se o disco rígido não está cheio. Em um computador desktop, se o problema surgiu após uma alteração no sistema operacional ou no driver, obtenha uma atualização compatível do driver de vídeo do fabricante do computador ou da placa de vídeo. Se um software de segurança sinalizou um arquivo do Kodi, revise o alerta e use um instalador oficial confiável; não desative a proteção globalmente. Em TVs e dispositivos de streaming, use a loja de aplicativos e atualizações integrada do dispositivo.
A visualização de configurações ilustra as verificações básicas de integridade do dispositivo.
4. Faça backup do Kodi e, em seguida, teste um perfil limpo.
Feche o Kodi completamente e copie toda a pasta de dados do Kodi para um local seguro. Ela contém complementos, configurações, bancos de dados e outras alterações; copiar apenas userdatanão é um backup completo.
Os locais de instalação mais comuns são %APPDATA%\Kodino Windows, ~/.kodino Linux e ~/Library/Application Support/Kodino macOS. As instalações na loja e as instalações portáteis podem ser diferentes. Consulte o guia de pastas de dados do Kodi para outros caminhos.
Com o Kodi fechado, renomeie a pasta de dados, adicionando um sufixo como `.kodi.data` .saved, e então abra o Kodi para criar uma nova pasta. Se ela abrir, o perfil antigo provavelmente é a causa do problema. Para desfazer o teste, feche o Kodi, mova a nova pasta para outro local e restaure o nome original da pasta salva. Dispositivos Android e TV podem restringir o acesso; não selecione "Limpar dados" sem um backup verificado.
Mantenha uma cópia separada dos dados do Kodi antes de alterar o perfil.
5. Isole um complemento alterado recentemente.
Se um perfil limpo for aberto, inspecione o perfil antigo. O Kodi armazena os arquivos dos complementos instalados no addonsdiretório da pasta de dados; userdata/addon_dataessa pasta também contém as configurações de alguns complementos. São pastas diferentes, conforme explicado na documentação da pasta de dados do Kodi .
Com o Kodi fechado e seu backup intacto, mova a pasta de um complemento de terceiros alterado recentemente para addonsuma pasta separada. Não exclua a pasta nem mova pastas que você não consiga identificar. Inicie o Kodi. Se o problema parar, deixe o complemento desinstalado até que uma atualização compatível esteja disponível; caso contrário, restaure-o e tente o próximo complemento que possa estar causando o problema. Se você não conseguir acessar as pastas com segurança, use o registro de eventos em vez de tentar adivinhar.
Mova temporariamente o complemento suspeito para o lado para que a alteração possa ser revertida.
6. Verifique o registro da falha.
Os caminhos de log comuns são os mesmos %APPDATA%\Kodi\kodi.logno Windows, ~/.kodi/temp/kodi.logno Linux e ~/Library/Logs/kodi.logno macOS. Outras plataformas têm caminhos diferentes; consulte o guia de arquivos de log do Kodi .
Procure por erros ou nomes de complementos perto do final do Kodi, antes que ele seja encerrado, mas considere isso como uma pista, não como prova. Um novo lançamento rotaciona o registro atual, então a sessão com falha pode estar em algum lugar no registro kodi.old.log. Os registros podem revelar nomes de pastas pessoais ou credenciais de complementos; oculte detalhes privados antes de compartilhá-los.
Uma linha de log está destacada para revisão; não se trata de um erro específico do Kodi.
7. Reinstale somente se o teste de limpeza falhar.
Reinstale o aplicativo a partir da página oficial de downloads do Kodi ou da loja da sua plataforma, mantendo a pasta de dados salva. A remoção do aplicativo pode manter o perfil salvo, o que significa que uma reinstalação pode reutilizar as mesmas configurações corrompidas. Mantenha a pasta renomeada até confirmar que o Kodi inicia corretamente; nunca sobrescreva seu backup.
Se o aplicativo abrir, adicione novamente apenas as configurações e extensões necessárias, uma de cada vez, reiniciando entre as alterações. Dê preferência ao repositório do Kodi ou à fonte mantida pelo autor do complemento. Se mesmo com um perfil limpo e a versão estável mais recente, o aplicativo continuar apresentando falhas, compartilhe o registro de eventos e os detalhes do dispositivo com a comunidade de suporte oficial do Kodi.
A ilustração do download oficial representa a reinstalação do Kodi após um backup.Após uma instalação limpa, adicione as extensões de volta uma de cada vez.
Para evitar travamentos recorrentes: mantenha o software compatível atualizado, faça backup antes de atualizações importantes, use fontes confiáveis de complementos e faça alterações uma de cada vez.