xVAULT

KO | EN

gitlite — search

#postgresql #javascript #security #data-science #android #typescript #react #nextjs #claude-code #chatbot

(★ 9)

Kodi-Video-Add-on für Filme, Serien, Collections und LiveTV mit Quellenverwaltung, Wiedergabestatus, Synchronisation und eigener Repo-Page.

File Explorer

ZIP Download

- - bug_report.yml
  - config.yml
  - feature_request.yml
- pull_request_template.md
- .htaccess
- config.example.php
- index.php
- - icon.png
- - plugin.video.xvault-2026.09.04.2.zip
  - plugin.video.xvault-2026.09.05.1.zip
  - plugin.video.xvault-2026.09.13.1.zip
- - index.html
- - addon.xml
  - icon.png
  - index.html
  - plugin.video.xvault-2026.09.04.2.zip
  - plugin.video.xvault-2026.09.05.1.zip
  - plugin.video.xvault-2026.09.13.1.zip
- - addon.xml
  - icon.png
  - index.html
  - repository.xvault-1.0.2.zip
- - index.html
- .nojekyll
- addons.xml
- addons.xml.md5
- CNAME
- firetv-stick-simulator.md
- index.html
- repository.xvault-1.0.1.zip
- repository.xvault-1.0.2.zip
- repository.xvault.zip
- style.css
- sync.md
- - __init__.py
  - art.py
  - bookmarkDB.py
  - control.py
  - dependencies.py
  - downloader.py
  - first_install.py
  - hoster_compat.py
  - linear_tv.py
  - linear_tv_lite.py
  - log_utils.py
  - mediainfo.py
  - ParameterHandler.py
  - playback_settings.py
  - playcountDB.py
  - player.py
  - plus.py
  - provider_logins.py
  - pyaes.py
  - repository.py
  - requestHandler.py
  - searchDB.py
  - seriesqueue.py
  - settings_repair.py
  - sources.py
  - startup_info.py
  - supportinfo.py
  - telemetry.py
  - tmdb.py
  - tmdbhelper_integration.py
  - tmdbhelper_player.py
  - tools.py
  - trailer.py
  - trakt.py
  - updater.py
  - utils.py
  - watch_progress.py
  - watched_status.py
- - 01_01_filme_neue_suche_tmdb.png
  - 01_02_suchverlauf_loeschen.png
  - 01_suche_filme.png
  - 02_01_serien_neue_suche_tmdb.png
  - 02_02_suchverlauf_loeschen.png
  - 02_suche_tv_serien.png
  - 03_01_darsteller_neue_suche.png
  - 03_02_suchverlauf_loeschen.png
  - 03_darsteller_suche_nach_person.png
  - 04_01_filme_neu.png
  - 04_02_filme_jahr.png
  - 04_03_filme_genres.png
  - 04_04_filme_am_populaersten.png
  - 04_05_filme_am_besten_bewertet.png
  - 04_06_filme_meist_bewertet.png
  - 04_07_filme_bestes_einspielergebnis.png
  - 04_filme.png
  - 05_01_serien_genres.png
  - 05_02_serien_am_populaersten.png
  - 05_03_serien_am_besten_bewertet.png
  - 05_04_serien_meist_bewertet.png
  - 05_tv_serien.png
  - 06_01_support_informationen_anzeigen.png
  - 06_02_xvault_einstellungen.png
  - 06_03_resolver_einstellungen.png
  - 06_werkzeuge.png
  - 07_stream_url_abspielen.png
  - _movies-search.png
  - _people-search.png
  - _search.png
  - _series-search.png
  - banner.png
  - box-office.png
  - downloads.png
  - genres.png
  - highly-rated.png
  - icon.png
  - in-theaters.png
  - most-popular.png
  - most-voted.png
  - movies.png
  - next.png
  - no-picture.png
  - plugin-info.png
  - poster.png
  - resolveurl.png
  - tmdb_search.png
  - tools.png
  - tvshows.png
  - url.png
  - years.png
- - addon.xml
- - xvault.json
- __init__.py
- downloadinfo.txt
- fanart.png
- icon.png
- settings.py
- settings.xml
- - __init__.py
  - cleantitle.py
  - dom_parser.py
  - getcontent.py
  - jsunpack.py
  - jsunpacker.py
  - source_utils.py
  - tools.py
- - __init__.py
- __init__.py
- animetoast.py
- aniworld.py
- bsto.py
- cineto.py
- einschalten.py
- fhdfilme.py
- filmfans.py
- filmo.py
- filmpalast.py
- filmpro.py
- hdfilme.py
- huhu.py
- internetarchive.py
- kinoger.py
- kinokiste.py
- kinox.py
- kkiste.py
- megakino.py
- moflix.py
- movie2k.py
- movie2k2.py
- movie4k.py
- netzkino.py
- nox.py
- README.md
- serienfans.py
- serienstream.py
- streamcloud.py
- streamcloudforum.py
- topstreamfilm.py
- vixstream.py
- - 20260718_xvault_telemetry.sql
  - 20260718_xvault_telemetry_stats.sql
  - 20260718_xvault_telemetry_update_events.sql
  - 20260720_xvault_stats_lifetime_curves.sql
  - 20260720_xvault_telemetry_android_tv.sql
  - 20260724_xvault_telemetry_release_channels.sql
  - 20260726_xvault_telemetry_os_versions.sql
- build_kodi_zip.py
- check_readme_version.py
- firetv_stick_simulator.py
- kodi_firetv_test.py
.gitignore
.iptv_merge
addon.xml
CHANGELOG.md
CHANGELOG.txt
CODE_OF_CONDUCT.md
CONTRIBUTING.md
default.py
DEPENDENCIES.md
LICENSE
README.md
SECURITY.md
service.py
THIRD_PARTY_NOTICES.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

xVAULT ist ein Kodi-Video-Add-on zum Durchsuchen und Wiedergeben von Filmen, TV-Serien und LiveTV.

## Aktuelle Version

Aktueller Stand: `2026.09.13.1`

Die führende Versionsquelle ist [`addon.xml`](addon.xml). Wenn die Version in `addon.xml` geändert wird, muss diese README geprüft und bei Bedarf aktualisiert werden.

## Installation

1. Die aktuelle Add-on-ZIP von [xvault.ddnss.de](http://xvault.ddnss.de/) herunterladen.
2. In Kodi **Add-ons > Aus ZIP-Datei installieren** öffnen.
3. Die Datei `plugin.video.xvault-2026.09.13.1.zip` auswählen.
4. xVAULT starten.

Alternativ kann das Repository-ZIP von [http://xvault.ddnss.de/repository.xvault.zip](http://xvault.ddnss.de/repository.xvault.zip) installiert werden. Danach findet Kodi neue xVAULT-Versionen über das Repository.

Kodi installiert die offiziellen Abhängigkeiten aus den konfigurierten Repositorys. Damit eine direkte ZIP-Installation nicht an noch fehlenden Modulen scheitert, installiert und aktiviert xVAULT seine benötigten Laufzeitmodule beim ersten Start zusätzlich selbst. Nicht im offiziellen Kodi-Repo verfügbare Module wie ResolveURL werden dabei aus ihren offiziellen Quellen nachinstalliert. Optionale binäre InputStream-Komponenten werden nicht beim Pluginstart erzwungen, weil sie je nach Kodi-Plattform nicht immer verfügbar sind.

Weitere Hinweise zu Abhängigkeiten stehen in [`DEPENDENCIES.md`](DEPENDENCIES.md).

## Nutzung

- Das ausführliche Handbuch steht als GitHub-Pages-Unterseite unter [xvault.ddnss.de/handbuch/](http://xvault.ddnss.de/handbuch/) bereit.
- Filme und Serien über die xVAULT-Menüs suchen.
- LiveTV und LiveTV lite über Senderkategorien oder eigene TV-Favoriten starten.
- Eine Quelle auswählen oder Autoplay verwenden.
- Favoriten und Wiedergabestände optional über den Kontenbereich synchronisieren.
- Gesehene Folgen, Staffeln und Serien werden aus den aktuellen Wiedergabeständen abgeleitet.

## Funktionen

- Suche und Wiedergabe von Filmen, TV-Serien und LiveTV.
- Film- und Serienlisten können über TMDb-Watch-Provider nach Streaming-Anbietern im deutschen Markt gefiltert werden; danach nutzt xVAULT weiterhin die normale Quellen- und Resolverlogik.
- xVAULT kann als Player für TMDbHelper genutzt werden, ohne die eigene Quellenlogik, Resolver-Auswahl und Wiedergabeüberwachung zu verlieren.
- Der Hauptmenüpunkt `Collections` zeigt Filmreihen aus Filmo, speichert die Übersichten 24 Stunden im Cache, sortiert enthaltene Filme chronologisch und filtert die Detailansicht über TMDb-Filmreihen gegen offensichtliche Fremdtreffer.
- Das Playback-Label zeigt beim laufenden Stream Hoster und Indexseite an, z.B. `VOE @ SerienStream`.
- Serien zeigen vorhandene Specials aus TMDB-Staffel 0 als eigenen Staffel-Eintrag an; Sonderfolgen bleiben beim Abspielen echte Serienfolgen.
- SerienStream verwendet `serienstream.to`; alte gespeicherte Domainwerte werden automatisch auf diese Domain migriert.
- SerienStream.to arbeitet ohne Zugangsdatenpflicht; die Quellensuche läuft auch ohne hinterlegte Login-Daten.
- SerienStream und AniWorld gleichen Serien- und Episodentreffer über Titel, Slugs, Jahr, Kapitelnummern und deutsche/englische Episodentitel robuster ab; Untertitelvarianten werden nicht mehr als Tonspur-Sprache gewertet.
- SerienStream prüft bei abweichender Anbieter-Staffelzählung Episodentitel und Erstausstrahlung, damit Folgen auch dann gefunden werden, wenn TMDB/xVAULT und Anbieter die Staffeln unterschiedlich schneiden; gleiche Veröffentlichungsdaten mehrerer Folgen werden dabei nicht mehr als eindeutiger Treffer behandelt.
- Serienwiedergaben starten auch dann stabil, wenn Metadaten aus Favoriten, alten Listen oder Android/Kodi-Varianten nur `imdb_id` statt `imdbnumber` liefern; Startfehler werden im Kodi-Log klarer protokolliert.
- VOE-Quellen können direkt in xVAULT aufgelöst werden, wenn die installierte ResolveURL-Version die aktuelle VOE-Ausweichdomain noch nicht kennt.
- xVAULT kennt zusätzliche VOE-, Streamix-, Playmate- und FireStream-Ausweichdomains, damit Quellen auch dann nutzbar bleiben, wenn die installierte ResolveURL-Version diese Domains noch nicht selbst enthält.
- KinoGer-Spezialhosts werden gezielt dem passenden Resolver zugeordnet; bei `kinoger.be` bevorzugt xVAULT echte HLS-Varianten statt problematischer Werbe-Playlists.
- Der KinoGer-Scraper gibt erkannte Spezialhosts als Resolver-Quellen weiter, damit Dialog, Verzeichnis und Autoplay denselben geprüften Auflösungsweg verwenden.
- Nicht aufgelöste Hoster-Seiten werden nicht mehr als Video an Kodi übergeben; xVAULT versucht stattdessen weitere Quellen oder meldet, dass keine nutzbare Quelle verfügbar ist.
- Beim Wechsel von der Quellensuche in die Quellenliste schließt xVAULT Kodis Busy-Overlay gezielt, damit die fertige Liste nicht hinter einer weiterdrehenden Ladeanzeige liegen bleibt.
- Autoplay und manuelle Streamauswahl begrenzen hängende Resolver- und Player-Starts per Timeout; bei Autoplay probiert xVAULT danach weitere gefundene Quellen und beendet die Wiedergabeüberwachung auch ohne Kodi-Stop-Callback sauber.
- Gefundene Quellenlisten für Filme und Serien werden im Kodi-Profil zwischengespeichert. Beim erneuten Quellenwechsel für denselben Titel kann xVAULT die Liste wiederverwenden, während Hoster-Links weiterhin frisch aufgelöst und getestet werden.
- Serien merken sich erfolgreiche Anbieter für spätere Folgen derselben Serie, damit passende Indexseiten schneller nach vorne rücken, ohne andere aktive Anbieter dauerhaft auszuschließen.
- Fehlerhafte oder hängende Indexseiten werden nur kurzzeitig übersprungen, damit ein einzelner Timeout die Suche nicht bei jedem Start erneut ausbremst.
- Fehlerhafte oder hängende Hoster-Auflösungen werden ebenfalls kurzzeitig pro Provider-/Hoster-Kombination übersprungen, damit ein erneuter Quellenwechsel nicht sofort wieder an derselben problematischen Quelle startet.
- Die parallele Quellensuche passt die Thread-Anzahl an die Plattform an und bereitet bei Autoplay mehrere aussichtsreiche Quellen parallel vor, behält aber die bisherige Sortier- und Auswahlreihenfolge bei.
- Streamquellen für Filme und Serien können nach bevorzugter Sprache sortiert oder gefiltert werden; mehrere Scraper liefern Deutsch/Englisch-Varianten sauber an die Quellenliste, und Autoplay wird bei Sprache `Alle` automatisch in Dialog oder Verzeichnis umgestellt.
- Die Standard-Aktion `Dialog`, `Verzeichnis` oder `Autoplay` wird beim Start von Filmen und Folgen frisch aus Kodis aktuellem Add-on-Setting gelesen; die Profil-Datei dient als Rückfall. Alte Favoriten oder externe Aufrufe frieren die Auswahl nicht mehr auf einen früheren Wert ein.
- Die Standard-Aktion wird über einen xVAULT-eigenen Auswahl-Dialog gespeichert und migriert alte `hosts.mode.v2`-/`hosts.mode`-/`default.action`-Werte automatisch, damit Kodi-Defaultwerte die Auswahl nicht mehr auf Autoplay zurücksetzen.
- xVAULT schreibt Kodi-Settings nur, wenn sich der Zielwert wirklich geändert hat; identische Werte werden übersprungen, um die Profil-Settings zu schonen.
- Filmpalast liest die aktuelle Such- und Quellenstruktur, schützt bereits korrekt kodierte Suchpfade vor Doppel-Kodierung, durchsucht mehrere Trefferseiten und übernimmt erkannte Hoster erst ohne vorzeitige ResolveURL-Filterung in die Quellenliste.
- Filmo ist als aktivierbare Filmquelle in die normale Quellensuche eingebunden; xVAULT liest Filmo-Suche und Filmseiten, löst Providerchips mit CSRF-Token, Session-Cookies und Redirect-Auswertung über den Filmo-Mint-Endpunkt auf und übernimmt Deutsch-/Englisch-Hoster in die Quellenliste.
- MoFlix ist als optionale Film- und Serienquelle eingebunden; xVAULT prüft Treffer über Titel, Jahr und IMDb-ID, verwirft nicht nutzbare direkte HLS-Kandidaten und bereitet unterstützte Spiegel als normale ResolveURL-Quellen vor.
- AnimeToast ist als eigener Serien-Scraper eingebunden. xVAULT nutzt dort nur konkrete Episoden aus der Ajax-Playerlogik oder eindeutige Einzel-Episodenlinks; reine Staffelbereichs-Container werden nicht als einzelne Folge übernommen.
- Internet Archive ist als optionale Filmquelle vorhanden. Die Suche ist bewusst streng auf passende Titel-/Jahr-Treffer und echte Videodateien begrenzt, damit Archiv-, Bonus- oder Trailer-Treffer die normale Quellenliste nicht verfälschen.
- Quellenlisten behalten die vom Scraper gelieferte Reihenfolge, werden nach Qualitäts-/Sprachlogik stabil dedupliziert und berücksichtigen manuelle Hoster-Ausschlüsse erst danach.
- Kodi-Wrapper für Add-on, Fenster, Dialoge, Player, Playlists und Fortschrittsdialoge werden kontrolliert erzeugt und beim Add-on-Ende freigegeben, damit Kodi nach xVAULT-Aufrufen keine unnötigen CPythonInvoker-Cleanup-Warnungen protokolliert.
- Scraper erhalten die ResolveURL-Hosterliste aus den installierten ResolveURL-Plugin-Dateien, damit Quellen von FHDFilme, HDfilme, Megakino, StreamCloud, TopStreamFilm und ähnlichen Anbietern nicht mehr vorzeitig ausgefiltert werden; die eigentliche ResolveURL-Auflösung wird erst beim Start einer Quelle geladen und danach wieder aus dem xVAULT-Invoker gelöst.
- Settings-Lesezugriffe nutzen Profil- und Default-XML mit Cache, damit aktuelle Kodi-Einstellungen sofort greifen und keine unnötigen Add-on-Wrapper entstehen.
- Die Standard-Aktion `Verzeichnis` liefert Quellenlisten auch aus Favoriten, RPC- und externen Aufrufen wieder als Kodi-Verzeichnis, statt ungewollt in den Dialog zurückzufallen.
- VIXSTREAM-Playlist-Streams ohne `.m3u8`-Endung werden als HLS erkannt und behalten die benötigten Vixcloud-Header beim Kodi-Start im Abspielpfad, damit Manifest, Segmente und AES-Schlüssel erreichbar bleiben.
- VIXSTREAM prüft die tatsächlichen HLS-Audiospuren und zeigt eine Quelle nur als Deutsch oder Englisch an, wenn die angeforderte Sprache als Tonspur vorhanden ist; Untertitel zählen nicht als Streamsprache.
- Optionale InputStream-Komponenten werden beim Pluginstart, bei Film-/Serien-HLS und bei der Kodi-TV-/IPTV-Simple-Integration nicht mehr erzwungen; xVAULT nutzt vorhandene Engines oder fällt auf Kodis interne Wiedergabe zurück.
- Movie4k nutzt die aktuelle API-Struktur über `movie4k.sx`; alte Movie4k-Domainwerte werden beim Providercheck automatisch auf die funktionierende Domain migriert.
- Neuer Einstellungsbereich `Indexseiten 3 (DE)` für CINE.TO, FILMFANS, NOX, SERIENFANS und STREAMCLOUD.FORUM; der bisherige Bereich `Indexseiten (DE)` heißt jetzt `Indexseiten 1 (DE)`.
- Bei einer frischen Erstinstallation startet xVAULT mit Streamsprache Deutsch und Standard-Aktion Autoplay; bestehende Profile und Updates behalten ihre gewählten Einstellungen.
- AniWorld.to ist als optionaler Serienanbieter eingebunden und kann in den Indexseiten aktiviert oder deaktiviert werden; Zugangsdaten sind optional im Kontenbereich hinterlegbar.
- Fortsetzen von Wiedergaben und automatische Lesezeichen.
- Angefangene Filme und Folgen bleiben ungesehen, zeigen ein Uhrsymbol und nennen die Fortsetzen-Position direkt hinter dem Titel.
- Gesehen-Haken für Filme und Folgen erscheinen erst, wenn höchstens noch zehn Minuten Restlaufzeit übrig sind oder die Wiedergabe regulär endet.
- Gesehen/Ungesehen-Status für Filme, Folgen, Staffeln und Serien.
- Nach beendeter Wiedergabe wird der Gesehen-Status aktualisiert, ohne dass die Auswahl mehrfach zwischen alter Position und nächster ungesehener Folge springt.
- Nach dem Stoppen oder Ende eines Streams nutzt xVAULT keine blinde Kodi-ParentDir-Navigation mehr, sondern kehrt über den gespeicherten xVAULT-Containerpfad zurück, damit Kodi auf verschiedenen Plattformen geöffnet bleibt.
- DNS over HTTPS ist standardmäßig aktiv und kann in den allgemeinen Einstellungen deaktiviert werden. xVAULT nutzt Cloudflare für die DNS-Auflösung seiner HTTP-Anfragen; die aktivierten Indexseiten laufen über dieselbe RequestHandler-Logik, feste IPs bleiben nur Rückfall.
- xVAULT-Synchronisation für Favoriten und Wiedergabestände.
- Die xVAULT-Synchronisation nutzt den API-Host `all-stats.de` für Favoriten- und Binge-/Wiedergabestände.
- Bei der Sync-Registrierung prüft xVAULT die E-Mail-Adresse auf plausibles Format und die API zusätzlich, ob die angegebene Domain per DNS erreichbar ist.
- Favoriten werden revisionsbasiert als einzelne Einträge mit Löschmarken synchronisiert; Geräte übertragen nur neue, geänderte oder gelöschte Favoriten, statt bei jedem Abgleich den kompletten Favoritenbestand zu senden.
- Die Synchronisation gleicht gespeicherte Login-Daten automatisch ab, damit Server-Backups auch nach einem veralteten lokalen API-Key wiederhergestellt werden können.
- `Jetzt synchronisieren` bereinigt doppelte lokale Fortsetzen-Einträge und bricht dadurch nicht mehr mit einem PluginError ab, wenn alte Bookmark-Daten mehrfach vorhanden sind.
- Sync-Zustandsdateien werden bei kurz gesperrten Profil-Dateien mit Retry und Fallback geschrieben, damit Wiedergabeende und Synchronisation keine unnötigen Datei-Zugriffsfehler erzeugen.
- Über **Werkzeuge > Support** kann ein redigiertes Diagnosepaket erstellt, nach Bestätigung hochgeladen und über eine kurze Service-ID weitergegeben werden; lokale ZIP-Dateien werden nach dem Upload gelöscht.
- Beschädigte gespeicherte xVAULT-Einstellungen werden beim Pluginstart erkannt; der Nutzer kann die defekte `settings.xml` sichern und zurücksetzen lassen. Dieselbe Prüfung ist unter **Werkzeuge > Reparatur** sowie in den Einstellungen unter **Wartung & Support** manuell erreichbar.
- Automatische Updateprüfung kann in den allgemeinen Einstellungen aktiviert oder deaktiviert werden.
- LiveTV-Senderliste mit lokalem Cache, Kategorien, Suche, eigenen TV-Favoriten, Senderlogos, einstellbarer Stream-Puffergröße, plattformneutraler HLS-Wiedergabe-Engine, wahlweiser reiner M3U/XMLTV-Erstellung, nutzergesteuerter Kodi-TV/IPTV-Simple-Integration, wiederholter HLS-Stabilitätsprüfung, passendem Ersatzstream-Fallback, EPG-Vorschau für aktuell laufende und folgende Sendungen sowie einer Senderlisten-Prüfung, die vor dem Start warnt, am Ende per Ergebnisdialog geprüfte, funktionierende und temporär gesperrte Sender zählt und nicht erreichbare Sender temporär bis zum nächsten xVAULT-Hauptstart ausblendet.
- LiveTV lite liest Deutsche TV-, Österreichische TV- und Schweizer TV-Sender direkt aus der 2ix2-WordPress-API, besitzt einen eigenen TV-Favoritenordner und startet die dort hinterlegten HLS-Streams schlank ohne EPG-Schicht; wenn 2ix2 temporär nicht erreichbar ist, nutzt xVAULT Nydus als Ersatzquelle und löst dort echte HLS-Streams beim Start dynamisch auf.
- Interne Downloads und externe Download-Manager sind getrennt: lokale Downloads benötigen Zielordner, My.JDownloader/JDownloader/PyLoad erscheinen unabhängig davon im Kontextmenü einzelner Quellen, wenn die Quellenansicht als Verzeichnis geöffnet wird.

## Fehler und Vorschläge melden

Fehler und Verbesserungsvorschläge bitte über [GitHub Issues](https://github.com/mojomedia1812/xVAULT/issues) melden. Dort gibt es Vorlagen für Fehlermeldungen und Feature-Wünsche.

Gute Fehlermeldungen enthalten:

- verwendete xVAULT-Version
- Kodi-Version und System
- genaue Schritte zum Nachstellen
- erwartetes und tatsächliches Verhalten
- Screenshots oder Logs, falls vorhanden

## Sicherheit

Sicherheitslücken bitte nicht öffentlich in Issues, Diskussionen oder Foren melden. Die Meldewege, unterstützten Versionen und der Umfang sicherheitsrelevanter Meldungen stehen in [`SECURITY.md`](SECURITY.md).

## Verhaltenskodex

Für Issues, Pull Requests, Diskussionen und Projektkommunikation gilt der [`Code of Conduct`](CODE_OF_CONDUCT.md).

## Lizenz

xVAULT wird unter der GNU General Public License Version 3 only (`GPL-3.0-only`) veröffentlicht. Der vollständige Lizenztext steht in [`LICENSE`](LICENSE).

Im Repository enthaltene Drittkomponenten behalten ihre jeweiligen Lizenz- und Copyright-Hinweise. Eine kurze Übersicht steht in [`THIRD_PARTY_NOTICES.md`](THIRD_PARTY_NOTICES.md).

## Umami Analytics

Umami wird zur datenschutzfreundlichen Besuchsstatistik der GitHub Page genutzt. Die Website-ID kommt aus Umami und ist im Tracking-Code der HTML-Seiten unter `docs/` eingetragen.

Der Tracking-Code befindet sich in der bestehenden GitHub-Page-Hauptdatei `docs/index.html`, in der Handbuch-Unterseite `docs/handbuch/index.html` und wird für die generierten Repository-Listings über `tools/build_kodi_zip.py` ausgegeben. Umami ist damit auf allen relevanten GitHub-Pages-Seiten eingebunden.

Do Not Track wird respektiert, URL-Suchparameter werden nicht gesammelt und Linkklicks auf Downloads, Repository-Dateien, GitHub-Links und wichtige interne Links werden als Umami-Events erfasst. Event-Namen enthalten keine privaten Nutzerdaten.

Es werden keine Zugangsdaten, Secrets, geheimen API-Schlüssel oder personenbezogenen Inhalte ins Repository geschrieben. Falls eine Datenschutzerklärung für die öffentliche Nutzung gepflegt wird, sollte dort die Nutzung von Umami für Seitenstatistik und Linkklicks sachlich ergänzt werden.

## Add-on-Nutzungsstatistik

Die optionale xVAULT-Nutzungsstatistik nutzt die xVAULT-API als Backend und kann im eigenen Add-on-Einstellungsbereich **Statistik** aktiviert oder deaktiviert werden. Neue Profile starten mit aktivierter Statistik.

Erfasst werden nur technische Lebenszyklusdaten: Installation erstellt, Add-on gestartet, Add-on beendet, Heartbeat alle 30 Minuten, Kodi-Version, xVAULT-Version, OS-Klasse, Geräteklasse, Online-Status und zuletzt gesehen. Das Plugin sendet keine Titel, Suchbegriffe, Stream-URLs, Favoriten, Zugangsdaten, geheimen API-Schlüssel, privaten Pfade oder persönlichen Eingaben.

Die lokale Installation-ID ist eine zufällig erzeugte UUID. Auf dem API-Server wird sie vor der Speicherung gehasht. Heartbeats aktualisieren nur den aktuellen Geräte-/Sitzungszustand; technische Ereignisse werden serverseitig verdichtet, damit die Datenmenge klein bleibt.

## Mitwirken

Hinweise für Beiträge stehen in [`CONTRIBUTING.md`](CONTRIBUTING.md).

Bei Änderungen an Version, Einstellungen oder Funktionen muss diese README geprüft und bei Bedarf aktualisiert werden.

## Changelog

- Repository- und Dokumentationsänderungen: [`CHANGELOG.md`](CHANGELOG.md)
- Plugin-Versionshistorie: [`CHANGELOG.txt`](CHANGELOG.txt)

## Kompatibilität

xVAULT ist ein Kodi-Python-3-Add-on und deklariert in [`addon.xml`](addon.xml) `xbmc.python` ab Version `3.0.0`. Die Python-Laufzeitmodule und ResolveURL werden beim Start geprüft und bei Bedarf über Kodi beziehungsweise die hinterlegten offiziellen Quellen installiert und aktiviert. Optionale binäre InputStream-Komponenten werden beim Start nicht erzwungen, weil sie plattformabhängig sind und auf einzelnen Kodi-Ports fehlen können. Der IPTV Simple Client wird nicht mehr beim xVAULT-Start oder nach Updates automatisch installiert oder aktiviert; xVAULT fragt nur bei der ausdrücklich ausgewählten Kodi-TV-Integration nach. LiveTV-HLS funktioniert plattformneutral: xVAULT nutzt automatisch FFmpeg Direct, wenn es auf der Plattform installiert und aktiviert ist, und fällt sonst auf Kodis interne HLS-Wiedergabe zurück. InputStream Adaptive bleibt als manuell auswählbare Alternative erhalten.

Für Android-basierte Fire-TV-Stick-Tests gibt es einen Profil-Simulator unter [`docs/firetv-stick-simulator.md`](docs/firetv-stick-simulator.md). Er ersetzt keinen echten FireOS-ROM-Emulator, hilft aber beim Prüfen von Fire OS, Android-API-Level, RAM, Codec-Klasse und Kodi-Risiken und kann Android-TV-AVD-Testprofile nach dem Amazon-AVD-Vorgehen skizzieren.

Für Kodi mit installiertem xVAULT gibt es zusätzlich `tools/kodi_firetv_test.py`. Der Standardlauf zielt auf `aftmm`, also Fire TV Stick 4K - 1st Gen, und prüft neben Kodi-Smoke-Tests auch lokale Datenbankkonsistenz bei simuliertem Speicher- und Schreibfehlerdruck.

xVAULT

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README