01 — Das Addon-System in Kodi: Wie es funktioniert
Kodi ist ohne Addons ein reiner lokaler Mediaplayer. Erst durch Erweiterungen – Addons genannt – entstehen die Funktionen, die Kodi zu einem vollständigen Mediacenter machen: Live-TV via PVR, Metadaten-Scraping für Filmbibliotheken, alternative Benutzeroberflächen (Skins) und zahlreiche weitere Dienste.
Technisch ist ein Addon ein Python-Skript oder ein natives Plugin, das in Kodis Addon-Architektur eingebettet wird. Jedes Addon hat eine eigene addon.xml-Manifestdatei, die Name, Version, Abhängigkeiten und Berechtigungen definiert. Kodi verwaltet Addons über einen integrierten Addon-Manager, der sowohl Installation als auch Updates übernimmt.
Das Addon-System ist hierarchisch strukturiert: Repositories sind übergeordnete Verzeichnisse, die mehrere Addons bündeln und aktuell halten. Einzelne Addons können direkt aus einem Repository oder als ZIP-Datei installiert werden.
Installierte Addons liegen unter .kodi/addons/, die Konfigurationsdaten unter .kodi/userdata/addon_data/. Beide Verzeichnisse sind für manuelle Backups und Migrationen relevant.
02 — Das offizielle Kodi-Repository
Das offizielle Kodi-Repository ist die sicherste Quelle für Addons. Es wird vom Kodi-Entwicklerteam kuratiert, jedes enthaltene Addon wird auf Schadcode und Qualität geprüft, bevor es aufgenommen wird. Das Repository ist in Kodi 21 Omega standardmäßig aktiviert und benötigt keine manuelle Einrichtung.
Für IPTV-Nutzung enthält das offizielle Repository alle relevanten technischen Addons:
- PVR IPTV Simple Client – M3U/XMLTV-Integration für Live-TV
- Skin-Addons – Estuary (Standard), Estouchy (Touch), Confluence
- Metadaten-Scraper – The Movie Database (TMDb), TheTVDB
- Untertitel-Addons – OpenSubtitles, Subscene
- Bibliotheks-Addons – Kodi-interne Bibliotheksverwaltung
Das offizielle Repository enthält ausdrücklich keine Addons, die direkten Zugang zu Streaming-Inhalten bereitstellen. Diese finden sich ausschließlich in externen Repositories und liegen außerhalb der Kontrolle des Kodi-Projekts.
Bevor ein externes Repository hinzugefügt wird, lohnt es sich zu prüfen, ob das benötigte Addon bereits im offiziellen Kodi-Repository verfügbar ist. Das spart Aufwand und vermeidet Sicherheitsrisiken.
03 — Externe Repositories: Chancen und klare Grenzen
Externe Repositories erweitern Kodi um Addons, die aus verschiedenen Gründen nicht im offiziellen Repository aufgenommen werden: weil sie auf Dienste mit regionalen Einschränkungen zugreifen, weil sie nicht den Qualitätsstandards entsprechen oder weil ihre Inhalte rechtlich unklar sind.
| Eigenschaft | Offizielles Kodi-Repo | Externe Repositories |
|---|---|---|
| Sicherheitsprüfung | Ja – vom Kodi-Team | Nein – Betreiber-abhängig |
| Qualitätskontrolle | Vorhanden | Variiert stark |
| Rechtliche Klarheit | Gegeben | Oft unklar |
| Update-Zuverlässigkeit | Hoch | Schwankend |
| Addon-Auswahl | Begrenzt (offiziell) | Sehr groß |
| Technische Addons | Vollständig | Vorhanden |
Externe Repositories werden nicht von Kodi überwacht. Schadhafte Repositories können Python-Code auf dem Gerät ausführen. Nur Repositories aus bekannten, quelloffenen und vertrauenswürdigen Projekten installieren. Repositories, die nicht mehr aktiv gepflegt werden, deinstallieren.
04 — Repository über Quell-URL installieren: Schritt für Schritt
Bevor ein externes Repository installiert werden kann, muss in Kodi die Option "Unbekannte Quellen" aktiviert werden. Kodi zeigt dabei einen Sicherheitshinweis, der bewusst bestätigt werden muss:
Unbekannte Quellen aktivieren
Einstellungen → System → Addons → Unbekannte Quellen einschalten → Sicherheitswarnung bestätigen
Dateimanager öffnen und Quelle hinzufügen
Einstellungen → Dateimanager → Quelle hinzufügen → URL des Repository-Servers eingeben → Namen vergeben (z. B. "Mein Repo")
Repository-Addon aus der Quelle installieren
Addons → Addon aus ZIP-Datei installieren → gespeicherte Quelle auswählen → Repository-ZIP-Datei auswählen
Addons aus dem Repository installieren
Addons → Aus Repository installieren → installiertes Repository auswählen → gewünschtes Addon auswählen → Installieren
05 — Addon direkt aus ZIP-Datei installieren
Einzelne Addons können ohne Repository direkt als ZIP-Datei installiert werden. Das ist nützlich für Addons, die nicht in einem öffentlichen Repository verfügbar sind, oder wenn ein Repository-Server temporär nicht erreichbar ist.
Die ZIP-Datei muss die korrekte Addon-Struktur enthalten: im Wurzelverzeichnis der ZIP muss ein Ordner mit dem Addon-Namen liegen, der die addon.xml und alle Python-Dateien enthält. Falsch verpackte ZIPs führen zu Installationsfehlern ohne klare Fehlermeldung.
- ZIP-Datei auf ein zugängliches Medium kopieren (USB, interner Speicher, Netzlaufwerk)
- Kodi → Addons → Addon aus ZIP-Datei installieren → Speicherort navigieren
- ZIP auswählen → Kodi installiert das Addon und zeigt eine Bestätigungsmeldung
- Addon-Einstellungen direkt im Anschluss konfigurieren
Wenn ein Addon Abhängigkeiten hat, die nicht im offiziellen Kodi-Repository verfügbar sind, müssen diese ebenfalls manuell als ZIP installiert werden. Die benötigten Abhängigkeiten stehen in der addon.xml des Addons unter dem <requires>-Abschnitt.
06 — Addon-Typen im Kodi-Ökosystem
Das Kodi-Addon-System unterscheidet zwischen verschiedenen Typen, die unterschiedliche Funktionen innerhalb des Mediencenters übernehmen. Für IPTV-Nutzung sind besonders PVR-Clients und Video-Addons relevant:
| Addon-Typ | Funktion | IPTV-relevant | Beispiel |
|---|---|---|---|
| PVR-Client | Live-TV über M3U/XMLTV in Kodi integrieren | Ja | PVR IPTV Simple Client |
| Video-Addon | Zugang zu Videoinhalten über externe Quellen | Indirekt | Diverse (Repository-abhängig) |
| Skin | Benutzeroberfläche von Kodi anpassen | Indirekt | Estuary, Aeon Nox Silvo |
| Metadaten-Scraper | Film/Serien-Informationen abrufen | Nein | TMDb, TheTVDB |
| Service-Addon | Hintergrundprozesse (z. B. Trakt.tv Sync) | Nein | Trakt, Kodi Callbacks |
| Repository-Addon | Verzeichnis für weitere Addons | Ja | Kodi Official Repository |
| Untertitel-Addon | Untertitel-Download automatisieren | Optional | OpenSubtitles |
07 — Kodi Skins für IPTV-Nutzung optimieren
Der Standard-Skin Estuary ist für IPTV-Nutzung gut geeignet und zeigt den EPG-Programmführer übersichtlich an. Für Nutzer, die Kodi primär als IPTV-Interface verwenden, gibt es Skins, die die Senderlistenansicht in den Vordergrund stellen:
- Aeon Nox Silvo – populärer dritter Skin mit breiter Community-Unterstützung, TV-orientiertem Layout
- Arctic Zephyr 2 – modernes Design, gute EPG-Integration
- Mimic – leichtgewichtig, klares Layout, gut für schwächere Hardware
- Estouchy – offizieller Touch-optimierter Skin für Tablets
Skin-Wechsel erfolgt über: Einstellungen → Oberfläche → Skin → Skin ändern. Nach dem Wechsel muss Kodi neu gestartet werden. Skin-spezifische Einstellungen (z. B. EPG-Fenstergröße, Farbthema) sind über die jeweiligen Skin-Einstellungen zugänglich.
08 — Addon-Updates und Versionsverwaltung
Kodi prüft installierte Addons automatisch auf Updates, wenn die jeweiligen Repositories erreichbar sind. Das Update-Verhalten lässt sich pro Addon und global konfigurieren:
- Automatische Updates: Einstellungen → Addons → Update-Benachrichtigungen → gewünschtes Verhalten wählen
- Manuelle Updates: Meine Addons → Addon auswählen → Aktualisierungen prüfen
- Version einfrieren: Automatische Updates für ein Addon deaktivieren (sinnvoll bei bekannt stabiler Version)
Bei großen Kodi-Versionssprüngen (z. B. von Kodi 20 Nexus auf 21 Omega) sind externe Addons nicht zwingend kompatibel. Kompatibilität prüfen, bevor ein Update durchgeführt wird – der Repository-Betreiber kommuniziert dies normalerweise in den Release-Notes.
Vor einem Kodi-Hauptversionsupdate den kompletten .kodi-Ordner sichern. So lässt sich im Fehlerfall auf die funktionierende Konfiguration zurückwechseln, ohne alle Addons neu einrichten zu müssen.
09 — Addon-Quellen im Vergleich: Wann welche wählen?
| Installationsweg | Aufwand | Auto-Updates | Empfohlen für |
|---|---|---|---|
| Offizielles Kodi-Repository | Sehr gering | Ja | PVR-Clients, Scraper, Skins – alles was dort verfügbar ist |
| Externes Repository (URL) | Mittel | Ja (wenn aktiv) | Addons, die nicht im offiziellen Repo sind und von aktiver Community gepflegt werden |
| ZIP-Datei (direkt) | Mittel | Nein | Einmalige Installation, Test-Versionen, Addons ohne Repository |
| Manuell (Dateien kopieren) | Hoch | Nein | Entwicklung, Debugging, Sonderfälle |
10 — Diagnose: Addon-Fehler gezielt beheben
Addon-Probleme äußern sich meist durch Fehlermeldungen beim Start, leere Inhaltsseiten oder Abstürze. Die Diagnose beginnt immer im Kodi-Log:
| Fehlerbild | Ursache | Lösung |
|---|---|---|
| Addon konnte nicht geladen werden | Python-Abhängigkeit fehlt oder inkompatible Kodi-Version | Kodi-Log prüfen; Abhängigkeit manuell installieren oder Addon aktualisieren |
| Repository nicht erreichbar | Server offline oder URL geändert | URL im Browser testen; Repository-Betreiber kontaktieren; ggf. deinstallieren |
| Addon zeigt leere Seite | API-Verbindungsfehler oder fehlende Anmeldedaten | Addon-Einstellungen prüfen; Anmeldedaten neu eingeben; Netzwerk testen |
| ZIP-Installation schlägt fehl | Falsche ZIP-Struktur oder beschädigte Datei | ZIP erneut herunterladen; Struktur mit ZIP-Viewer prüfen |
| Kodi-Absturz nach Addon-Installation | Speicherleck oder Python-Fehler im Addon | Addon deaktivieren; Log-Analyse; bei Wiederholung deinstallieren |
Weiterführende Anleitungen
Dieser Pillar-Artikel behandelt das Addon-Ökosystem von Kodi. Für die konkrete Repository-Installation mit Schritt-für-Schritt-Anleitung und Sicherheitshinweisen: