Files
ViewIT/README.md

88 lines
2.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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>