# Kodi Addon Installation Guide

## Voraussetzungen

- Kodi 21+ (Matrix/Omega) empfohlen
- Aktiver Internetzugang
- Xtream-Codes-API-Login-Daten (falls IPTV-Provider genutzt wird)

## Installation der Addons

### Methode 1: Aus dem Workspace (lokal)

Der Workspace ist unter https://kodi.itsok.giize.com erreichbar.

1. **XStream-Player-Kodi21**:
   - Repo: https://github.com/Pesicp/XStream-Player-Kodi21
   - In Kodi: `Einstellungen → Add-ons → Add-on-Browser → Aus ZIP installieren`
   - Wähle `addons/XStream-Player-Kodi21/` aus (falls als `.zip` verpackt)

2. **XStreamPro** (erweitert):
   - Repo: https://github.com/Pesicp/XStreamPro
   - Gleiche Vorgehensweise wie oben

3. **Vavoo (plugin.video.vavooto)**:
   - Im **Michaz Repository** enthalten
   - Repo-Zip: https://kodi.itsok.giize.com/addons/michaz-repo.zip
   - In Kodi installieren → dann über Michaz-Repo das Vavoo-Addon holen

### Methode 2: Entwicklungs-Modus (Symlink)

Für Entwicklung direkt vom Quellcode:

```bash
# Symlink in Kodi-Addons-Verzeichnis (Linux):
ln -s /home/kosti/workspace/KODI/addons/XStreamPro \
      ~/.kodi/addons/plugin.video.xstreampro
```

### Methode 3: ch.repo Sammlung

- Repo: https://github.com/christianhaitian/ch.repo
- Enthält diverse Helfer- und Streaming-Addons
- Als ZIP in Kodi installieren

## Konfiguration

Nach der Installation der Xtream-Addons:

1. **Xtream-Codes einrichten**:
   - URL: Deinen Anbieter eingeben
   - Nutzername + Passwort: Von deinem IPTV-Provider
   - EPG + Picons: Optional aktivieren

2. **M3U-Playlist** (falls kein Xtream-Code):
   - XStream-Player unterstützt direkte M3U-URLs
   - Format: `http://dein-server:8080/get.php?username=xxx&password=yyy&type=m3u`

## Caching-Policy (Server-seitig)

- HTML/JS: **no-cache** (stets frisch)
- ZIP/Assets (Addons, Icons): **7 Tage Cache** (langsamere Clients profitieren)

## Troubleshooting

- **"Addon startet nicht"**: Prüfe Kodi-Version (Python 3.11+ für Kodi 21)
- **"Xtream-Code login fehlgeschlagen"**: Teste URL/Nutzer mit `curl` direkt
- **"SSL-Zertifikat-Fehler"**: Zertifikat erneuern via `certbot --nginx -d kodi.itsok.giize.com`