Wie man ResolveURL in Kodi, dem URLResolver-Fork, verwendet

ResolveURL ist eine Hintergrundabhängigkeit von Kodi und kein Videokatalog oder eigenständiger Player. Die meisten Nutzer sollten das entsprechende Add-on aus einem vertrauenswürdigen Repository installieren; Kodi kann ResolveURL dann als Abhängigkeit installieren. Um dies zu überprüfen, öffnen Sie den Kodi-Abhängigkeitsmanager. Add-on-Entwickler können script.module.resolveurlResolveURL in ihrem Manifest deklarieren und die aktuelle Python-API verwenden.

ResolveURL ist eine Abspaltung von URLResolver. Das Projekt wird script.module.resolveurlvom Kodi-Repository unter der Bezeichnung „ResolveURL“ geführt und dort veröffentlicht. Der Projektindex listete am 27. Oktober 2026 Version 5.1.212 auf; die aktuelle Version finden Sie im Live-Index, da sich diese ändern kann. ResolveURL verarbeitet ausschließlich Links, die vom eigenen Code unterstützt werden, und durchsucht das Web nicht nach Filmen oder Serien. Verwenden Sie es nur für Inhalte, für die Sie die entsprechenden Zugriffsrechte besitzen.

Was ResolveURL in Kodi bewirkt

Ein Kodi-Add-on kann eine Seiten- oder Dateihost-URL erhalten, die selbst kein direkt abspielbarer Stream ist. ResolveURL versucht, unterstützte Links in eine Stream-URL umzuwandeln, die Kodi öffnen kann. Es handelt sich um eine gemeinsam genutzte Bibliothek, die auch von anderen Add-ons verwendet wird. Daher interagieren Sie normalerweise mit dem übergeordneten Add-on, anstatt ResolveURL über den Kodi-Startbildschirm zu öffnen.

ResolveURL und der ältere URLResolver sind separate Add-on-Pakete. Ein Fork ersetzt nicht automatisch alle älteren Abhängigkeiten und repariert kein Add-on, das nicht mehr funktioniert. Lesen Sie die Dokumentation des jeweiligen Add-ons, bevor Sie Änderungen vornehmen oder etwas entfernen.

Installieren Sie es auf normalem Wege.

1. Beginnen Sie mit dem Add-on, das die Abhängigkeit benötigt. Öffnen Sie in Kodi die Add-ons , wählen Sie „ Aus Repository installieren“ , wählen Sie den Herausgeber des Add-ons oder ein anderes vertrauenswürdiges Repository aus und installieren Sie anschließend das kompatible Add-on. Falls dessen Manifest ResolveURL erfordert und die Abhängigkeit in einem installierten Repository verfügbar ist, übernimmt Kodi die Installation der Abhängigkeit während der Einrichtung.
2. Verwenden Sie das Entwickler-Repository nur bei Bedarf. Falls der Herausgeber Sie ausdrücklich auf das Repository von ResolveURL verweist, laden Sie die Repository-ZIP-Datei aus dem ZIP-Archiv des Maintainers herunter . Öffnen Sie den ZIP-Archivordner und wählen Sie das aktuelle repository.resolveurlPaket aus. Eine Repository-ZIP-Datei registriert eine Aktualisierungsquelle; sie ist nicht das ResolveURL-Modul selbst.
3. Installieren Sie die ZIP-Datei in Kodi. Wählen Sie im Add-ons-Browser „ Aus ZIP-Datei installieren“ , navigieren Sie zum Speicherort der ZIP-Datei und wählen Sie diese aus. Kodi fragt Sie möglicherweise, ob Sie die Installation von Add-ons aus unbekannten Quellen zulassen möchten. Fahren Sie nur fort, wenn Sie der Quelle vertrauen: Kodi warnt davor, dass Add-ons aus unbekannten Quellen auf persönliche Daten auf dem Gerät zugreifen können. Die genaue Menüstruktur kann je nach Kodi-Version oder -Skin variieren.
4. Lassen Sie das abhängige Add-on das Modul herunterladen und überprüfen Sie es anschließend. Installieren oder aktualisieren Sie das Add-on, das ResolveURL deklariert. Um das Ergebnis zu überprüfen, gehen Sie zu Einstellungen > System > Add-ons > Abhängigkeiten verwalten und suchen Sie nach ResolveURL. Falls diese Einstellung ausgeblendet ist, ändern Sie die Einstellungsebene unten links auf „ Erweitert“ . Eine aufgeführte, aktivierte Abhängigkeit bestätigt, dass Kodi das Modul installiert hat; dies garantiert jedoch nicht, dass jeder Host-Link aufgelöst wird.

Der Add-ons-Browser trennt die ZIP-Installation vom Durchsuchen installierter Repositories.

Kodi warnt davor, dass Add-ons aus unbekannten Quellen persönliche Daten offenlegen können.

Wählen Sie die Repository-ZIP-Datei aus, die Sie aus dem Archiv des Maintainers erhalten haben.

Unter „Abhängigkeiten verwalten“ kann überprüft werden, ob ResolveURL vorhanden und aktiviert ist.

Verwenden Sie ResolveURL in einem Add-on

Für Entwickler: Fügen Sie ResolveURL als erforderliche Abhängigkeit in der Konfiguration des Add-ons hinzu addon.xml. Das Attribut „Version“ gibt die Mindestversion an, die Ihr Code benötigt; passen Sie diese an die verwendete API und die unterstützten Kodi-Versionen an.

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

Verwenden Sie anschließend die Schnittstelle des Upstream-Projekts HostedMediaFile, um eine unterstützte Quell-URL zu überprüfen und aufzulösen:

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

Die resultierende URL darf erst dann an den Wiedergabeablauf von Kodi übergeben werden, nachdem geprüft wurde, ob sie verwendbar ist. Ein falsches oder fehlendes Ergebnis kann bedeuten, dass der Host nicht unterstützt wird, die Quell-URL abgelaufen ist, der Host seine Seite geändert hat oder die Anfrage fehlgeschlagen ist. Der Resolver kann nicht verfügbare oder nicht autorisierte Inhalte nicht wiedergeben.

Die aktuelle Benutzeroberfläche und ein Beispiel für Abhängigkeiten sind im Quellcode-Repository von ResolveURL dokumentiert . Die Anleitung zum Add-on-Manifest von Kodi erläutert die automatische Auflösung von Abhängigkeiten, und die Referenz zu den Add-on-Einstellungen beschreibt die Verwaltung von Abhängigkeiten und unbekannten Quellen.

Fehlerbehebung ohne Beeinträchtigung anderer Add-ons

• „Abhängigkeit nicht verfügbar“: Aktualisieren Sie das Repository, das das übergeordnete Add-on bereitstellt, prüfen Sie, ob Kodi über eine Internetverbindung verfügt, und vergewissern Sie sich, dass das Add-on Ihre Kodi-Version unterstützt. Kodi kann nur Abhängigkeiten installieren, die aus einem konfigurierten Repository stammen oder vom Herausgeber bereitgestellt werden.
• ResolveURL fehlt oder ist deaktiviert: Überprüfen Sie die Abhängigkeitsliste und die Installationsmeldung des Add-ons. Aktualisieren Sie aus demselben vertrauenswürdigen Repository, aus dem das Add-on stammt; vermeiden Sie die Vermischung von ZIP-Dateien aus nicht zusammengehörigen Builds.
• Ein Link funktioniert weiterhin nicht: Prüfen Sie, ob der Quelllink gültig und unterstützt ist, und überprüfen Sie anschließend das Protokoll oder die Supportseite des übergeordneten Add-ons. ResolveURL funktioniert möglicherweise nicht mehr für einen bestimmten Host, wenn dieser seinen Dienst ändert.
• Entfernen eines alten Resolvers: Löschen Sie die Add-on-Ordner von Kodi nicht manuell. Kodi kann die Deinstallation einer Abhängigkeit verhindern, solange diese von einem anderen Add-on verwendet wird. Entfernen Sie den Resolver über Kodi nur dann, wenn der Abhängigkeitsmanager ihn als verwaist markiert oder kein Add-on ihn benötigt.

Kurz gesagt: Installieren Sie das Add-on, das ResolveURL benötigt, aus einer vertrauenswürdigen Quelle, lassen Sie Kodi die Abhängigkeiten verwalten und nutzen Sie die gepflegte Projektdokumentation, wenn Sie selbst ein Add-on entwickeln. Vermeiden Sie Repositories oder Add-ons, die urheberrechtlich geschützte Streams ohne Genehmigung anbieten.