# KODI Workspace — Addons & Streaming-Infrastruktur

Lokale Sammlung wichtiger Kodi-Addons für IPTV/LIVE-TV, VOD und Xtream Codes.

## Struktur

```
KODI/
├── addons/                    # Addon-Quellen + Binary-Zips
│   ├── XStream-Player-Kodi21/    • Xtream Codes + M3U8 Addon (Live TV, Movies, Series)
│   ├── XStreamPro/               • Feature-reiche Version (TMDB, Trakt, Sports TV, Replay)
│   ├── vavoo-enigma2/            • Vavoo Stream Live Plugin (IPTV, mehrere Länder)
│   ├── kodi-xtream-vod-addon/    • Xtream VOD Addon (Video-on-Demand via Xtream API)
│   ├── ch-repo/                  • christianhaitian/ch.repo — Sammlung verschiedener Addons
│   └── michaz-repo.zip           • Michaz Repository (deutsche + internationale Addons)
├── docs/
│   └── INSTALLATION.md         • Installations-Anleitung für Kodi
├── README.md                     • Diese Datei
└── requirements.txt              • Entwicklungs-Abhängigkeiten
```

## Addons im Detail

### XStream-Player-Kodi21 (Pesicp)
- **Repo**: https://github.com/Pesicp/XStream-Player-Kodi21
- **Zweck**: Xtream Codes API + M3U-Playlists in Kodi einbinden
- **Features**: Live TV, Movies, Series, EPG, Picons, Multi-DNS

### XStreamPro (Pesicp)
- **Repo**: https://github.com/Pesicp/XStreamPro
- **Zweck**: Erweiterte XStream-Variante
- **Features**: TMDB-Discovery, Trakt-Listen, Sports TV, Replay-TV

### Vavoo (Belfagor2005)
- **Repo**: https://github.com/Belfagor2005/vavoo
- **Zweck**: Enigma2-Erweiterung — Zugriff auf tausende Live-TV-Kanäle
- **Hinweis**: Original ist Enigma2, aber die Vavoo-IPTV-Community nutzt ähnliche Quellen. Für Kodi gibt es `plugin.video.vavooto` — siehe Michaz-Repo.

### kodi-xtream-vod-addon (Boc86)
- **Repo**: https://github.com/Boc86/kodi-xtream-vod-addon
- **Zweck**: IPTV VOD via Xtream API-Logins in Kodi-Bibliothek

### ch.repo (christianhaitian)
- **Repo**: https://github.com/christianhaitian/ch.repo
- **Zweck**: Sammlung verschiedener Kodi-Addons (IPTV, Subtitles, Utils)

### michaz-repo
- **Source**: https://michaz1988.github.io/repo/
- **Zweck**: Deutsche + internationale Video-Addons, enthält u.a. Vavoo-Addon für Kodi
- **Installation**: In Kodi als "Install from ZIP" auswählen

### 6. xVAULT / kodi-media-repo (mr-evil1)
- **Repo**: https://github.com/mr-evil1/kodi-media-repo
- **Live-Index**: https://mr-evil1.github.io/kodi-media-repo/
- **Zweck**: Komplettes Kodi-Repository mit vielen Streaming-Addons (STB Plus TV, IPTV Master, Megakino, uva.)
- **Installation**: Kodi-Dateimanager-Quelle hinzufügen:
  ```
  https://mr-evil1.github.io/kodi-media-repo/
  ```
- **Lokaler Mirror**: `addons/xVAULT/` (vollständiges Repo, inkl. `addons.xml`, `_generated_assets/`, allen Plugin-Vs.)

### 7. GIPTV (G00380316)
- **Repo**: https://github.com/G00380316/GIPTV
- **Zweck**: Xtream IPTV Plugin + kompiliertes Addon-Repo
- **Features**: IPTV/M3U/Xtream-Codes, Beginner-friendly

### 8. plugin.video.iptvxc (Nigel1992)
- **Repo**: https://github.com/Nigel1992/plugin.video.iptvxc
- **Zweck**: XC/XCUI Kodi Addon (für Kodi 21/Omega)
- **Features**: Schnelle Live/VOD-Navigation, persistentes file-basiertes Caching, konfigurierbarer Cache-Timeout pro Content-Type

### 9. pvr.iptvsimple (kodi-pvr)
- **Repo**: https://github.com/kodi-pvr/pvr.iptvsimple
- **Zweck**: Offizieller Kodi PVR IPTV Simple Client
- **Features**: EPG-Integration, Catchup, Timeshift, Web-Stream-Extrahierung

### 10. tbrek-kodi-repo (tbrek)
- **Repo**: https://github.com/tbrek/tbrek-kodi-repo
- **Zweck**: Kodi Addon für IPTV-Archiv-Downloads (IPTV Simple Client Archive)

### 11. plex-for-kodi (pannal)
- **Repo**: https://github.com/pannal/plex-for-kodi
- **Zweck**: Modifizierter offizieller Plex Client für Kodi
- **Features**: Video-Add-ons → Plex-Integration

## Installation in Kodi

Siehe `docs/INSTALLATION.md`.

## Caching-Policy (Server-seitig)

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

## Verwendung

- Für **Entwicklung** (Addon-Quellen direkt nutzen):
  ```bash
  # Symlink in Kodi addons-Verzeichnis (Linux):
  ln -s /home/kosti/workspace/KODI/addons/XStreamPro /home/kosti/.kodi/addons/plugin.video.xstreampro
  ```
- Für **Produktivsetzung** (.zip-Installs):
  ```bash
  # Kodi öffnen → Add-ons → Aus ZIP installieren
  ```

## Related
- Vavoo-IPTV-Engine: `/home/kosti/workspace/vavoo/` (lokaler Server, Port 4355)
- Media-Stack: `/home/kosti/workspace/media-stack/` (Nginx + PHP-FPM + Portale)