Wie erstellt und pflegt man ein Kodi (XBMC) Repository?

Kodi, ehemals bekannt als XBMC, ist eine leistungsstarke Open-Source-Mediensoftware, die es Nutzern ermöglicht, Inhalte wie Filme, Serien, Musik und mehr zu organisieren und abzuspielen. Mit einem eigenen Kodi-Repository (kurz: „Repo“) können Sie Add-ons hosten, teilen und aktualisieren. Diese Anleitung zeigt Ihnen Schritt für Schritt, wie Sie ein Repository erstellen und pflegen.

 

Inhaltsverzeichnis

  1. Was ist ein Kodi-Repository?
  2. Voraussetzungen für ein Repository
  3. Repository-Struktur und Dateien
  4. Add-ons für das Repository vorbereiten
  5. Eine addons.xml-Datei erstellen
  6. Die addons.xml.md5-Datei erstellen

 

1. Was ist ein Kodi-Repository?

Ein Kodi-Repository ist eine Sammlung von Add-ons, die es Nutzern ermöglicht, diese direkt aus Kodi herunterzuladen und zu aktualisieren. Es dient als zentrale Quelle für Add-ons und erleichtert die Wartung und Verteilung.

2. Voraussetzungen für ein Repository

Bevor Sie starten, stellen Sie sicher, dass Sie folgende Dinge haben:

  • Grundkenntnisse in XML.
  • Add-ons , die Sie in Ihrem Repository hosten möchten. 
  • Einen Hosting-Server (z. B. GitHub, ein Webserver oder ein kostenloser Hosting-Dienst).
  • Einen Texteditor wie Notepad++ oder Visual Studio-Code .
  • Ein FTP-Programm (falls ein Webserver verwendet wird).

3. Repository-Struktur und Dateien

Eine typische Kodi-Repository-Struktur sieht wie folgt aus:

repository/  
│  
├── addons.xml  
├── addons.xml.md5  
├── addon/  
│   ├── addon_id/  
│       ├── addon.xml  
│       ├── icon.png  
│       ├── fanart.jpg  
│       └── resources/  
├── zip/  
    ├── addon_id/  
        └── addon_version.zip

Dateien im Repository:

  • addons.xml: Liste aller Add-ons.
  • addons.xml.md5: Hash-Datei zur Erkennung von Updates.
  • Add-on-Ordner: Enthält Add-on-Dateien und Ressourcen.
  • ZIP-Dateien: Komprimierte Add-ons für den Download.

4. Add-ons für das Repository vorbereiten

  1. Ordnerstruktur erstellen: Legen Sie für jedes Add-on einen Ordner an, der der Add-on-ID entspricht.
  2. Add-on-Dateien hinzufügen: In den Ordner kommen die addon.xml, Bilder (icon.png, fanart.jpg) und andere Ressourcen.
  3. ZIP-Dateien erstellen: Packen Sie die Add-on-Dateien in eine ZIP-Datei und speichern Sie sie im zip/-Ordner.

5. Eine addons.xml-Datei erstellen

Die addons.xml enthält Metadaten zu allen Add-ons.

 

Erstellungsschritte:

  1. Öffnen Sie einen Texteditor.
  2. Fügen Sie die Inhalte der addon.xml-Dateien der Add-ons zusammen:
<addons>  
    <addon id="addon_id_1" version="1.0.0" name="Addon Name 1">  
        <extension point="xbmc.addon.metadata">  
            <summary>Kurzbeschreibung</summary>  
            <description>Ausführliche Beschreibung</description>  
            <platform>all</platform>  
        </extension>  
    </addon>  
</addons>
  1. Speichern Sie die Datei als addons.xml.

6. Die addons.xml.md5-Datei erstellen

Diese Datei dient zur Erkennung von Änderungen im Repository.

So erstellen Sie die Datei:

  1. Generieren Sie einen MD5-Hash der addons.xml:
    bash
md5sum addons.xml > addons.xml.md5

Speichern Sie den Hash in der Datei addons.xml.md5.

7. Hosting des Repositories

Laden Sie die Dateien des Repositories auf einen Hosting-Server hoch, sodass diese über das Internet erreichbar sind.

 

Beispielhafte URLs:

  • addons.xml: https://example.com/repository/addons.xml
  • addons.xml.md5: https://example.com/repository/addons.xml.md5
  • ZIP-Dateien: https://example.com/repository/zip/addon_id/addon_version.zip

 

Empfohlene Hosting-Optionen:

  • GitHub Pages (kostenlos und einfach einzurichten).
  • Webserver wie Apache oder Nginx.
  • Cloud-Dienste wie Dropbox (sofern direkte Verlinkung unterstützt wird).

8. Das Repository testen

  1. Öffnen Sie Kodi.
  2. Navigieren Sie zu Einstellungen > Add-ons > Aus ZIP-Datei installieren.
  3. Installieren Sie Ihr Repository, indem Sie die ZIP-Datei des Repositories auswählen.
  4. Überprüfen Sie, ob die Add-ons im Repository sichtbar sind und installiert werden können.

9. Add-ons aktualisieren

Wenn ein Add-on aktualisiert werden muss:

  1. Versionsnummer ändern: Passen Sie die Versionsnummer in der addon.xml des Add-ons an.
  2. Neue ZIP-Datei erstellen: Erstellen Sie eine neue ZIP-Datei mit der aktualisierten Version.
  3. addons.xml-Datei aktualisieren: Ergänzen Sie die neuen Add-on-Daten.
  4. MD5-Hash generieren: Aktualisieren Sie die addons.xml.md5.
  5. Neue Dateien hochladen: Laden Sie alle aktualisierten Dateien auf den Hosting-Server.

10. Häufige Fehler und Lösungen

Fehler: Add-ons werden nicht angezeigt

  • Prüfen Sie die Dateistruktur des Repositories.
  • Stellen Sie sicher, dass die URLs korrekt sind.

Fehler: Updates werden nicht erkannt

  • Überprüfen Sie die MD5-Datei. Sie muss den aktuellen Hash der addons.xml enthalten.

Fehler: ZIP-Dateien können nicht heruntergeladen werden

  • Stellen Sie sicher, dass die Dateien korrekt auf dem Server hochgeladen wurden.
  • Prüfen Sie die Zugriffsrechte der Dateien.

11. FAQ zum Erstellen eines Kodi-Repositories

1. Kann ich mein Repository kostenlos hosten?
Ja, Plattformen wie GitHub Pages oder Dropbox bieten kostenfreie Hosting-Möglichkeiten.

2. Gibt es eine Begrenzung für Add-ons in einem Repository?
Nein, solange genügend Speicherplatz vorhanden ist, können beliebig viele Add-ons gehostet werden.

3. Muss ich programmieren können?
Nur Grundkenntnisse in XML und Dateistrukturen sind erforderlich.

4. Kann ich mein Repository privat halten?
Ja, durch Passwortschutz oder private Hosting-Dienste kann der Zugriff eingeschränkt werden.

5. Warum benötigt Kodi die MD5-Datei?
Die MD5-Datei hilft Kodi, Änderungen in der addons.xml zu erkennen und so neue Versionen zu laden.

6. Kann ich das Repository später aufteilen?
Ja, solange die Struktur und URLs korrekt bleiben, ist das problemlos möglich.

12. Fazit

Das Erstellen eines Kodi-Repositories ermöglicht die einfache Verteilung und Verwaltung von Add-ons. Mit der richtigen Struktur und einem guten Hosting-Service ist der Prozess unkompliziert und effizient. Befolgen Sie diese Anleitung, um Ihr eigenes Repository zu erstellen und erfolgreich zu verwalten.

Kodi-Repository mit einem Python-Repo-Generator erstellen

Python-Repo-Generatoren erleichtern den Prozess, ein Kodi-Repository zu erstellen und zu verwalten. Diese Tools automatisieren das Generieren von addons.xml, addons.xml.md5 und das Organisieren der Repository-Struktur.

Voraussetzungen

  1. Installieren Sie Python (Version 3.x empfohlen).
  2. Installieren Sie Git, falls der Generator von einem Repository heruntergeladen wird.
  3. Texteditor wie Visual Studio Code oder Notepad++.
  4. Add-ons, die Sie in das Repository aufnehmen möchten, als vorbereitete Ordner mit der addon.xml-Datei.

Schritte zur Erstellung eines Kodi-Repositories

1. Repo-Generator herunterladen

Laden Sie ein Python-Skript oder -Tool herunter, das speziell für Kodi-Repositories entwickelt wurde, z. B. Kodi Repo Generator.

git clone https://github.com/vikjon0/repository-generator.git cd repository-generator

2. Ordnerstruktur vorbereiten

Organisieren Sie Ihre Add-ons in einem Ordner. Die Struktur sollte wie folgt aussehen:

addons/
│
├── addon1/
│   ├── addon.xml
│   ├── icon.png
│   ├── fanart.jpg
│   └── resources/
│
└── addon2/
    ├── addon.xml
    ├── icon.png
    ├── fanart.jpg
    └── resources/

Legen Sie den Hauptordner für die Add-ons (z. B. addons/) in das gleiche Verzeichnis wie den Repo-Generator.

3. Repo-Generator ausführen

Rufen Sie das Python-Skript auf, um die notwendigen Dateien für Ihr Repository zu erstellen:

python generate.py --addons-path=./addons --output-path=./repository

Parameter:

  • --addons-path: Der Pfad zu Ihrem Add-ons-Ordner.
  • --output-path: Der Pfad, in dem die generierten Dateien gespeichert werden sollen.

Das Skript erstellt:

  • addons.xml
  • addons.xml.md5
  • ZIP-Dateien für jedes Add-on im Ordner repository/.

4. Repository testen

  1. Öffnen Sie Kodi.
  2. Gehen Sie zu Einstellungen > Add-ons > Aus ZIP-Datei installieren.
  3. Wählen Sie das generierte Repository-ZIP aus dem repository/-Ordner aus.

Add-ons aktualisieren

  1. Ändern Sie die addon.xml-Datei des Add-ons (z. B. Version anpassen).
  2. Führen Sie das Skript erneut aus:
python generate.py --addons-path=./addons --output-path=./repository
  1. Laden Sie die aktualisierten Dateien hoch.

Hosting des Repositories

Laden Sie die generierten Dateien auf einen Webserver oder eine Hosting-Plattform hoch. Nutzen Sie z. B.:

  • GitHub Pages: Laden Sie die Dateien in ein öffentliches Repository und aktivieren Sie Pages.
  • Webserver: Übertragen Sie die Dateien per FTP.
  • Cloud-Dienste wie Dropbox (mit Direktlinks).

Vorteile des Repo-Generators

  • Automatisierte Erstellung von addons.xml und ZIP-Dateien.
  • Weniger Fehleranfälligkeit durch manuelles Arbeiten.
  • Schnelle Updates durch erneutes Ausführen des Skripts.

Mit einem Python-Repo-Generator ist die Erstellung und Pflege eines Kodi-Repositories deutlich einfacher und schneller. Verwenden Sie diese Methode, um Ihre Add-ons effizient zu verwalten und zu verteilen.