Como usar o ResolveURL no Kodi, o fork do URLResolver

ResolveURL é uma dependência do Kodi que funciona em segundo plano, não um catálogo de vídeos ou um reprodutor independente. A maioria dos usuários deve instalar o complemento que precisa dele a partir de um repositório confiável; o Kodi poderá então instalar o ResolveURL como uma dependência. Para verificar, abra o gerenciador de dependências do Kodi. Os desenvolvedores de complementos podem declarar isso script.module.resolveurlem seu manifesto e usar a API Python atual do ResolveURL.

ResolveURL é um fork do URLResolver. O projeto principal identifica o pacote como ResolveURL script.module.resolveurle o publica através de um repositório separado do Kodi. O índice do projeto listava a versão 5.1.212 quando verificado em 27 de outubro de 2026; use o índice online para a versão atual, pois ela pode mudar. ResolveURL só lida com links suportados pelo seu código e não pesquisa filmes ou séries na web. Use-o com conteúdo ao qual você tenha direito de acesso.

O que o ResolveURL faz no Kodi

Um complemento do Kodi pode receber uma URL de página ou de servidor de arquivos que não seja um fluxo de reprodução direto. O ResolveURL tenta converter links compatíveis em URLs de fluxo que o Kodi possa abrir. Trata-se de uma biblioteca compartilhada usada por outros complementos, portanto, normalmente você interage com o complemento principal em vez de abrir o ResolveURL na tela inicial do Kodi.

ResolveURL e o antigo URLResolver são pacotes complementares separados. Um fork não substitui automaticamente todas as dependências antigas nem repara um pacote complementar que parou de funcionar. Consulte a documentação do pacote complementar antes de alterar ou remover qualquer coisa.

Instale-o da maneira usual.

1. Comece com o complemento que precisa dele. No Kodi, abra Complementos , escolha Instalar do repositório , selecione o editor do complemento ou outro repositório confiável e instale o complemento compatível. Se o manifesto exigir ResolveURL e a dependência estiver disponível em um repositório instalado, o Kodi cuidará da instalação da dependência durante a configuração.
2. Use o repositório do desenvolvedor somente quando necessário. Se o editor indicar especificamente o repositório do ResolveURL, obtenha o arquivo ZIP do repositório no repositório ZIP do mantenedor . Abra a pasta do arquivo ZIP e selecione o repository.resolveurlpacote desejado. Um arquivo ZIP de repositório registra uma fonte de atualização; não é o próprio módulo ResolveURL.
3. Instale o arquivo ZIP no Kodi. No navegador de complementos, escolha " Instalar a partir de um arquivo ZIP" , navegue até onde você salvou ou copiou o arquivo ZIP e selecione-o. O Kodi pode solicitar que você habilite fontes desconhecidas . Continue somente se confiar na fonte: o Kodi alerta que complementos de fontes desconhecidas podem acessar dados pessoais no dispositivo. O layout exato do menu pode variar de acordo com a versão ou tema do Kodi.
4. Deixe o complemento dependente baixar o módulo e, em seguida, verifique-o. Instale ou atualize o complemento que declara o ResolveURL. Para verificar o resultado, acesse Configurações > Sistema > Complementos > Gerenciar dependências e procure por ResolveURL. Se essa configuração estiver oculta, altere o nível de configurações no canto inferior esquerdo para Avançado . Uma dependência listada e ativada confirma que o Kodi a tem instalada; isso não garante que todos os links de host serão resolvidos.

O navegador de complementos separa a instalação de arquivos ZIP da navegação pelos repositórios instalados.

O Kodi alerta que complementos de fontes desconhecidas podem expor dados pessoais.

Selecione o arquivo ZIP do repositório que você obteve do arquivo do mantenedor.

Gerenciar dependências é o local para confirmar se o ResolveURL está presente e habilitado.

Use ResolveURL em um complemento.

Para desenvolvedores, adicione ResolveURL como uma dependência obrigatória no arquivo de configuração do complemento addon.xml. O atributo de versão indica a versão mínima necessária para o seu código; certifique-se de que corresponda à API que você utiliza e às versões do Kodi que você suporta.

<requires>
  <import addon="script.module.resolveurl" version="5.1.0" />
</requires>

Em seguida, utilize a interface do projeto upstream HostedMediaFilepara verificar e resolver uma URL de origem compatível:

import resolveurl

hosted_file = resolveurl.HostedMediaFile(source_url)
playable_url = hosted_file.resolve() if hosted_file else None

if not playable_url:
    # Report an unsupported or unavailable source to the user.
    pass

Passe a URL resultante para o fluxo de reprodução do Kodi somente após verificar se o resultado é utilizável. Um resultado falso ou ausente pode significar que o host não é suportado, a URL de origem expirou, o host alterou sua página ou a solicitação falhou. O resolvedor não pode tornar conteúdo indisponível ou não autorizado reproduzível.

A interface atual e o exemplo de dependência estão documentados no repositório de código-fonte do ResolveURL . O guia de manifesto de complementos do Kodi explica a resolução automática de dependências, e sua referência de configurações de complementos descreve o gerenciamento de dependências e as fontes desconhecidas.

Solucionar problemas sem afetar outros complementos.

• “Dependência não disponível”: Atualize o repositório que fornece o complemento principal, verifique se o Kodi tem acesso à internet e confirme se o complemento é compatível com a sua versão do Kodi. O Kodi só pode instalar dependências disponíveis em um repositório configurado ou fornecidas conforme as instruções do desenvolvedor.
• O ResolveURL está ausente ou desativado: verifique a lista de dependências do complemento e sua mensagem de instalação. Atualize a partir do mesmo repositório confiável que forneceu o complemento; evite misturar arquivos ZIP de versões diferentes.
• O link ainda falha: confirme se o link de origem é válido e compatível e, em seguida, verifique o log ou a página de suporte do complemento principal. O ResolveURL pode parar de funcionar para um determinado host quando esse host altera seu serviço.
• Removendo um resolvedor antigo: Não exclua as pastas de complementos do Kodi manualmente. O Kodi pode impedir a desinstalação de uma dependência enquanto outro complemento a estiver utilizando. Remova-a pelo Kodi somente quando o gerenciador de dependências a marcar como órfã ou quando nenhum complemento a exigir.

Resumindo, instale o complemento que precisa do ResolveURL a partir de uma fonte confiável, deixe o Kodi gerenciar as dependências e use a documentação do projeto, caso esteja desenvolvendo um complemento. Evite repositórios ou complementos que ofereçam conteúdo protegido por direitos autorais sem autorização.