# ViewIT

<img src="addon/resources/logo.png" alt="ViewIT Logo" width="220" />

**ViewIT** ist ein Kodi-Addon zum Streamen von Filmen und Serien aus verschiedenen Quellen – alles an einem Ort.

## Was kann ViewIT?

- **Filme und Serien** aus mehreren Streaming-Quellen durchsuchen und abspielen
- **Trakt-Anbindung** – Watchlist, Weiterschauen, Watch-History und automatisches Scrobbling
- **TMDB-Metadaten** – Poster, Beschreibungen, Bewertungen und Fanart automatisch laden
- **Autoplay** – Bevorzugten Hoster einstellen und direkt abspielen
- **Automatische Updates** – Neue Versionen werden erkannt und koennen direkt installiert werden

## Installation

1. Die neueste ZIP-Datei herunterladen (siehe [Releases](https://gitea.it-drui.de/viewit/ViewIT/releases))
2. In Kodi: **Einstellungen** > **Addons** > **Aus ZIP-Datei installieren**
3. Die heruntergeladene ZIP-Datei auswaehlen
4. ViewIT erscheint unter **Video-Addons**

### Updates

ViewIT kann sich selbst aktualisieren. In den Addon-Einstellungen unter **Updates** den gewuenschten Kanal waehlen:

- **Main** – Stabile Versionen
- **Nightly** – Aktuelle Entwicklungsversionen
- **Dev** – Neueste Aenderungen (kann instabil sein)

## Einstellungen

Die wichtigsten Einstellungen im Addon:

- **Quellen** – Basis-URLs der einzelnen Streaming-Seiten (falls sich Domains aendern)
- **Metadaten** – TMDB aktivieren/deaktivieren, Sprache einstellen
- **Wiedergabe** – Autoplay und bevorzugten Hoster festlegen
- **Trakt** – Konto verbinden fuer Watchlist und Scrobbling

## Voraussetzungen

- Kodi 19 (Matrix) oder neuer
- **ResolveURL** – wird beim ersten Start automatisch installiert (kann auch manuell ueber die Einstellungen nachinstalliert werden)

## Fuer Entwickler

<details>
<summary>Build und Projektstruktur</summary>

### Projektstruktur

```
addon/           Kodi-Addon Quellcode
  default.py     Hauptdatei und Router
  plugins/       Streaming-Plugins (eins pro Quelle)
  core/          Kernmodule (Trakt, Metadaten, Updates, ...)
  resources/     Einstellungen, Icons, Sprachdateien
scripts/         Build- und Deploy-Skripte
tests/           Automatisierte Tests
dist/            Build-Ausgaben
```

### Addon bauen

```bash
# Addon-Ordner erzeugen
bash scripts/build_install_addon.sh

# ZIP fuer Kodi-Installation erzeugen
bash scripts/build_kodi_zip.sh
```

### Tests ausfuehren

```bash
pip install -r requirements-dev.txt
pytest
```

### Lokales Kodi-Repository

```bash
bash scripts/build_local_kodi_repo.sh
bash scripts/serve_local_kodi_repo.sh
# Erreichbar unter http://127.0.0.1:8080/repo/addons.xml
```

</details>