Cómo usar ResolveURL en Kodi, la bifurcación de URLResolver

ResolveURL es una dependencia de Kodi que se ejecuta en segundo plano, no un catálogo de vídeo ni un reproductor independiente. La mayoría de los usuarios deberían instalar el complemento que lo necesite desde un repositorio de confianza; Kodi podrá entonces instalar ResolveURL como dependencia. Para comprobarlo, abre el gestor de dependencias de Kodi. Los desarrolladores de complementos pueden declararlo script.module.resolveurlen su manifiesto y utilizar la API de Python actual de ResolveURL.

ResolveURL es una bifurcación de URLResolver. El proyecto responsable identifica el paquete como script.module.resolveurly lo publica a través de un repositorio Kodi independiente. El índice del proyecto mostraba la versión 5.1.212 al consultarla el 27 de octubre de 2026; consulte el índice en vivo para obtener la versión actual, ya que puede cambiar. ResolveURL solo gestiona enlaces compatibles con su código y no busca películas ni series en la web. Úselo con contenido al que tenga derecho de acceso.

¿Qué hace ResolveURL en Kodi?

Un complemento de Kodi puede recibir una URL de página o de alojamiento de archivos que no sea una transmisión directa reproducible. ResolveURL intenta convertir los enlaces compatibles en una URL de transmisión que Kodi pueda abrir. Es una biblioteca compartida utilizada por otros complementos, por lo que normalmente se interactúa con el complemento principal en lugar de abrir ResolveURL desde la pantalla de inicio de Kodi.

ResolveURL y la versión anterior URLResolver son paquetes complementarios independientes. Una bifurcación no reemplaza automáticamente todas las dependencias anteriores ni repara un complemento que haya dejado de funcionar. Consulta la documentación del complemento antes de modificarlo o eliminarlo.

Instálalo de la forma habitual.

1. Comienza con el complemento que lo necesite. En Kodi, abre Complementos , selecciona Instalar desde repositorio , elige el editor del complemento u otro repositorio de confianza y, a continuación, instala el complemento compatible. Si su manifiesto requiere ResolveURL y la dependencia está disponible en un repositorio instalado, Kodi se encargará de la instalación de la dependencia durante la configuración.
2. Utilice el repositorio del desarrollador solo cuando sea necesario. Si el editor le indica específicamente que utilice el repositorio de ResolveURL, descargue el archivo ZIP del repositorio del responsable . Abra la carpeta del archivo ZIP y seleccione el repository.resolveurlpaquete actual. Un archivo ZIP de repositorio registra una fuente de actualización; no es el módulo ResolveURL en sí.
3. Instala ese archivo ZIP en Kodi. En el navegador de complementos, selecciona « Instalar desde archivo ZIP» , navega hasta donde guardaste o copiaste el archivo y selecciónalo. Es posible que Kodi te pida que actives la opción « Fuentes desconocidas» . Continúa solo si confías en la fuente: Kodi advierte que los complementos de fuentes desconocidas pueden acceder a datos personales del dispositivo. La disposición del menú puede variar según la versión o el tema de Kodi.
4. Deja que el complemento dependiente descargue el módulo y luego verifícalo. Instala o actualiza el complemento que declara ResolveURL. Para comprobar el resultado, ve a Ajustes > Sistema > Complementos > Gestionar dependencias y busca ResolveURL. Si esta opción está oculta, cambia el nivel de configuración en la parte inferior izquierda a Avanzado . Una dependencia listada y habilitada confirma que Kodi la tiene instalada; sin embargo, no garantiza que todos los enlaces de host se resuelvan.

El navegador de complementos separa la instalación de archivos ZIP de la exploración de los repositorios instalados.

Kodi advierte que los complementos de fuentes desconocidas pueden exponer datos personales.

Seleccione el archivo ZIP del repositorio que obtuvo del archivo del mantenedor.

En la sección Gestionar dependencias se puede confirmar que ResolveURL está presente y habilitado.

Utilice ResolveURL en un complemento

Para desarrolladores, agregue ResolveURL como una dependencia requerida en el complemento addon.xml. El atributo de versión indica la versión mínima que necesita su código; asegúrese de que coincida con la API que utiliza y las versiones de Kodi que admite.

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

Luego, utilice la interfaz del proyecto ascendente HostedMediaFilepara verificar y resolver una URL de origen compatible:

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

Solo después de verificar que el resultado sea válido, pásalo al flujo de reproducción de Kodi. Un resultado falso o inexistente puede significar que el servidor no es compatible, que la URL de origen ha caducado, que el servidor ha cambiado de página o que la solicitud ha fallado. El resolvedor no puede reproducir contenido no disponible o no autorizado.

La interfaz actual y el ejemplo de dependencia están documentados en el repositorio de código fuente de ResolveURL . La guía del manifiesto de complementos de Kodi explica la resolución automática de dependencias, y su referencia de configuración de complementos describe la gestión de dependencias y las fuentes desconocidas.

Soluciona problemas sin dañar otros complementos.

• «Dependencia no disponible»: Actualiza el repositorio que proporciona el complemento principal, comprueba que Kodi tenga acceso a internet y confirma que el complemento sea compatible con tu versión de Kodi. Kodi solo puede instalar dependencias disponibles en un repositorio configurado o proporcionadas según las instrucciones del editor.
• ResolveURL no está disponible o está deshabilitado: compruebe la lista de dependencias del complemento y su mensaje de instalación. Actualice desde el mismo repositorio de confianza que proporcionó el complemento; evite mezclar archivos ZIP de compilaciones no relacionadas.
• El enlace sigue fallando: confirme que el enlace de origen sea válido y compatible, y luego revise el registro o la página de soporte del complemento principal. ResolveURL puede dejar de funcionar para un host específico cuando este cambia su servicio.
• Eliminar un resolvedor antiguo: No borre manualmente las carpetas de complementos de Kodi. Kodi podría impedir la desinstalación de una dependencia mientras otro complemento la esté utilizando. Elimínela a través de Kodi solo cuando el administrador de dependencias la marque como huérfana o ningún complemento la requiera.

En resumen, instala el complemento que requiere ResolveURL desde una fuente confiable, deja que Kodi gestione su dependencia y utiliza la documentación del proyecto si estás desarrollando un complemento. Evita los repositorios o complementos que ofrecen transmisiones con derechos de autor sin autorización.