dev: bump to 0.1.91.0-dev pre-commit Hook synchronisiert Changelog-Version mit ZIP-Version

CHANGELOG-DEV.md

@@ -1,3 +1,79 @@
+## 0.1.90.5-dev - 2026-04-10
+
+- dev: bump to 0.1.90.0 Changelog und Release-Prozess fix
+
+## 0.1.90.0-dev - 2026-04-10
+
+- dev: bump to 0.1.89.5 Changelog aktualisiert
+
+## 0.1.89.5-dev - 2026-04-10
+
+- dev: bump to 0.1.89.0 Changelog komplett
+
+## 0.1.89.0-dev - 2026-04-10
+
+- dev: bump to 0.1.88.5 Changelog fuer aktuelle Version
+
+## 0.1.88.5-dev - 2026-04-10
+
+- dev: bump to 0.1.88.0 Changelog ergaenzt
+
+## 0.1.88.0-dev - 2026-04-10
+
+- dev: bump to 0.1.87.5 TMDb Helper Player, Metadaten-Fix, Menü-Icons, Filmpalast veeve
+
+## 0.1.87.5-dev - 2026-04-04
+
+- dev: bump to 0.1.87.0-dev Changelog-Prozess verbessert
+
+## 0.1.87.0-dev - 2026-04-04
+
+- dev: bump to 0.1.86.5-dev Trakt-Untermenue, Weiterschauen-Fixes, Scrobbling zuverlässig
+
+## 0.1.86.5-dev - 2026-04-03
+
+- dev: bump to 0.1.86.0-dev Globale Suche konfigurierbar, Changelog-Dialog beim ersten Start
+
+## 0.1.86.0-dev - 2026-04-02
+
+- dev: bump to 0.1.85.5-dev Settings-Menü benutzerfreundlicher gestaltet
+
+## 0.1.85.5-dev - 2026-04-02
+
+- dev: bump to 0.1.85.0-dev settings.xml und default.py auf 0.1.84.5-Stand zurueckgesetzt, serienstream_plugin.py aktuell behalten
+
+## 0.1.85.0-dev - 2026-04-01
+
+- dev: bump to 0.1.84.5-dev settings.xml auf Kodi 19+ Format (version=1) migriert, Level-Filter fuer Expert/Advanced korrigiert
+
+## 0.1.84.5-dev - 2026-03-31
+
+- dev: bump to 0.1.84.0-dev SerienStream Sammlungen mit Poster/Plot, Session-Cache für Sammlungs-URLs
+
+## 0.1.84.0-dev - 2026-03-16
+
+- dev: bump to 0.1.83.5-dev Trakt Weiterschauen via watched/shows, Specials überspringen
+
+## 0.1.83.5-dev - 2026-03-15
+
+- dev: SerienStream Suche via /suche?term=, Staffel 0 als Filme, Katalog-Suche entfernt
+
+## 0.1.83.0-dev - 2026-03-15
+
+- dev: Trakt Performance, Suchfilter Phrase-Match, Debug-Settings Expert-Level
+
+## 0.1.82.5-dev - 2026-03-15
+
+- dev: Update-Versionsvergleich numerisch korrigiert
+
+## 0.1.82.0-dev - 2026-03-14
+
+- dev: HDFilme Plot in Rubrik Neuste anzeigen
+
+## 0.1.81.5-dev - 2026-03-14
+
+- dev: YouTube HD via inputstream.adaptive, DokuStreams Suche fix
+
 ## 0.1.81.0-dev - 2026-03-14
 
 - dev: YouTube Fixes, Trakt Credentials fest, Upcoming Ansicht, Watchlist Kontextmenue

addon/CHANGELOG-USER.md

@@ -0,0 +1,155 @@
+## 0.1.91.0
+
+**Allgemein**
+- Changelog und Release-Prozess fix.
+- Changelog aktualisiert.
+
+
+## 0.1.90.0
+
+**TMDb Helper Integration**
+- Einstellungen → Tools: Player-Dateien für TMDb Helper direkt aus ViewIT installierbar
+- Zwei Player mitgeliefert: SerienStream (direkte Episodenwiedergabe) und Globale Suche
+- Menüpunkt ist ausgegraut wenn TMDb Helper nicht installiert ist
+
+**Metadaten / Poster**
+- Poster und Infos werden jetzt korrekt geladen wenn kein eigener TMDb-API-Key eingetragen ist
+- „Neueste Episoden" (SerienStream, Aniworld) zeigt jetzt Poster und Serieninfos
+
+**Topstreamfilm**
+- „Neueste Titel" entfernt – das Feature existiert auf der aktuellen Domain nicht
+
+**Filmpalast**
+- Hoster „Veev HD" wird jetzt erkannt und in der Hoster-Liste angezeigt
+
+**Kosmetik**
+- Menü-Icons für Hauptmenü, Plugin-Menüs und Trakt-Untermenü
+
+## 0.1.89.5
+
+**TMDb Helper Integration**
+- Einstellungen → Tools: Player-Dateien für TMDb Helper direkt aus ViewIT installierbar
+- Zwei Player mitgeliefert: SerienStream (direkte Episodenwiedergabe) und Globale Suche
+- Menüpunkt ist ausgegraut wenn TMDb Helper nicht installiert ist
+
+**Metadaten / Poster**
+- Poster und Infos werden jetzt korrekt geladen wenn kein eigener TMDb-API-Key eingetragen ist
+- „Neueste Episoden" (SerienStream, Aniworld) zeigt jetzt Poster und Serieninfos
+
+**Topstreamfilm**
+- „Neueste Titel" entfernt – das Feature existiert auf der aktuellen Domain nicht
+
+**Filmpalast**
+- Hoster „Veev HD" wird jetzt erkannt und in der Hoster-Liste angezeigt
+
+**Kosmetik**
+- Menü-Icons für Hauptmenü, Plugin-Menüs und Trakt-Untermenü
+
+## 0.1.88.5
+
+**TMDb Helper Integration**
+- Einstellungen → Tools: Player-Dateien für TMDb Helper direkt aus ViewIT installierbar
+- Zwei Player mitgeliefert: SerienStream (direkte Episodenwiedergabe) und Globale Suche
+- Menüpunkt ist ausgegraut wenn TMDb Helper nicht installiert ist
+
+**Metadaten / Poster**
+- Poster und Infos werden jetzt korrekt geladen wenn kein eigener TMDb-API-Key eingetragen ist
+- „Neueste Episoden" (SerienStream, Aniworld) zeigt jetzt Poster und Serieninfos
+
+**Topstreamfilm**
+- „Neueste Titel" entfernt – das Feature existiert auf der aktuellen Domain nicht
+
+**Filmpalast**
+- Hoster „Veev HD" wird jetzt erkannt und in der Hoster-Liste angezeigt
+
+**Kosmetik**
+- Menü-Icons für Hauptmenü, Plugin-Menüs und Trakt-Untermenü
+
+## 0.1.88.0
+
+**TMDb Helper Integration**
+- Einstellungen → Tools: Player-Dateien für TMDb Helper direkt aus ViewIT installierbar
+- Zwei Player mitgeliefert: SerienStream (direkte Episodenwiedergabe) und Globale Suche
+- Menüpunkt ist ausgegraut wenn TMDb Helper nicht installiert ist
+
+**Metadaten / Poster**
+- Poster und Infos werden jetzt korrekt geladen wenn kein eigener TMDb-API-Key eingetragen ist
+- „Neueste Episoden" (SerienStream, Aniworld) zeigt jetzt Poster und Serieninfos
+
+**Topstreamfilm**
+- „Neueste Titel" entfernt – das Feature existiert auf der aktuellen Domain nicht
+
+**Filmpalast**
+- Hoster „Veev HD" wird jetzt erkannt und in der Hoster-Liste angezeigt
+
+**Kosmetik**
+- Menü-Icons für Hauptmenü, Plugin-Menüs und Trakt-Untermenü
+
+## 0.1.87.5
+
+**TMDb Helper Integration**
+- Einstellungen → Tools: Player-Dateien für TMDb Helper direkt aus ViewIT installierbar
+- Zwei Player mitgeliefert: SerienStream (direkte Episodenwiedergabe) und Globale Suche
+- Menüpunkt ist ausgegraut wenn TMDb Helper nicht installiert ist
+
+**Metadaten / Poster**
+- Poster und Infos werden jetzt korrekt geladen wenn kein eigener TMDb-API-Key eingetragen ist (Fallback auf installierten Kodi-Scraper oder Community-Key war nicht aktiv)
+- „Neueste Episoden" (SerienStream, Aniworld) zeigt jetzt Poster und Serieninfos
+
+**Topstreamfilm**
+- „Neueste Titel" entfernt – das Feature existiert auf der aktuellen Domain nicht
+
+**Filmpalast**
+- Hoster „Veev HD" wird jetzt erkannt und in der Hoster-Liste angezeigt
+
+**Kosmetik**
+- Menü-Icons für Hauptmenü, Plugin-Menüs und Trakt-Untermenü
+
+## 0.1.87.0
+
+**Trakt**
+- Alle Trakt-Funktionen sind jetzt unter einem eigenen Untermenüpunkt „Trakt" gebündelt
+- Weiterschauen erkennt Staffelwechsel korrekt (z.B. S02E12 → S03E01 statt S02E13)
+- Scrobbling zuverlässiger: Episoden werden nicht mehr fälschlicherweise als gesehen markiert wenn die Streamlänge unbekannt ist
+- Trakt-IDs werden jetzt auch gefunden wenn TMDB die Serie nicht kennt
+
+
+
+## 0.1.86.5
+
+**Globale Suche**
+- Jedes Such-Plugin in den Einstellungen unter „Globale Suche" einzeln aktivierbar
+- YouTube optional als Suchquelle wählbar
+- Suchergebnisse zeigen den Anbieter in eckigen Klammern an, z.B. „Breaking Bad [Serienstream]"
+
+**Neu beim Start**
+- Nach einem Update wird automatisch ein Changelog-Dialog mit den Neuigkeiten angezeigt
+
+**Einstellungsmenü**
+- Neue Kategorie „Globale Suche" mit Checkboxen für alle Anbieter
+- Trakt-Verbindungsstatus direkt in den Einstellungen sichtbar
+- Bevorzugter Hoster als Auswahlliste, nur aktiv wenn Autoplay eingeschaltet ist
+
+## 0.1.86.0
+
+**Globale Suche verbessert**
+- Jedes Such-Plugin kann in den Einstellungen unter „Globale Suche" einzeln aktiviert oder deaktiviert werden
+- YouTube ist nun ebenfalls als optionale Suchquelle wählbar
+- Suchergebnisse zeigen jetzt den Anbieter in eckigen Klammern an, z.B. „Breaking Bad [Serienstream]"
+
+**Einstellungsmenü übersichtlicher**
+- Neue Kategorie „Globale Suche" mit Checkboxen für alle Anbieter
+- Trakt-Verbindungsstatus direkt in den Einstellungen sichtbar
+- Bevorzugter Hoster als Auswahlliste, nur aktiv wenn Autoplay eingeschaltet ist
+
+## 0.1.84.0
+
+**Trakt Weiterschauen**
+- Serien, die du bereits angeschaut hast, werden über Trakt als „Weiterschauen"-Liste angezeigt
+- Specials (Staffel 0) werden dabei automatisch übersprungen
+
+## 0.1.82.0
+
+**SerienStream Sammlungen**
+- Sammlungen auf SerienStream sind jetzt durchsuchbar
+- Die Liste wird alphabetisch sortiert und Sonderzeichen in Titeln werden bereinigt

addon/addon.xml

@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='utf-8'?>
-<addon id="plugin.video.viewit" name="ViewIt" version="0.1.81.5-dev" provider-name="ViewIt">
+<addon id="plugin.video.viewit" name="ViewIt" version="0.1.91.0-dev" provider-name="ViewIt">
   <requires>
     <import addon="xbmc.python" version="3.0.0" />
     <import addon="script.module.requests" />

addon/core/trakt.py

@@ -65,6 +65,8 @@ class TraktItem:
     episode_thumb: str = ""     # Screenshot-URL (extended=images)
     show_poster: str = ""       # Serien-Poster-URL (extended=images)
     show_fanart: str = ""       # Serien-Fanart-URL (extended=images)
+    # Staffel → höchste gesehene Episodennummer (für Staffelwechsel-Erkennung)
+    seasons_watched: dict = field(default_factory=dict)
 
 
 @dataclass(frozen=True)
@@ -370,6 +372,47 @@ class TraktClient:
             return []
         return self._parse_history_items(payload)
 
+    def get_watched_shows(self, token: str) -> list[TraktItem]:
+        """GET /users/me/watched/shows – alle Serien mit zuletzt gesehener Episode."""
+        status, payload = self._get("/users/me/watched/shows", token=token)
+        if status != 200 or not isinstance(payload, list):
+            self._do_log(f"get_watched_shows: status={status}")
+            return []
+        result: list[TraktItem] = []
+        for entry in payload:
+            if not isinstance(entry, dict):
+                continue
+            show = entry.get("show") or {}
+            ids = self._parse_ids((show.get("ids") or {}))
+            title = str(show.get("title", "") or "")
+            year = int(show.get("year", 0) or 0)
+            seasons = entry.get("seasons") or []
+            last_season = 0
+            last_episode = 0
+            seasons_watched: dict[int, int] = {}
+            for s in seasons:
+                snum = int((s.get("number") or 0))
+                if snum == 0:  # Specials überspringen
+                    continue
+                max_ep = 0
+                for ep in (s.get("episodes") or []):
+                    enum = int((ep.get("number") or 0))
+                    if enum > max_ep:
+                        max_ep = enum
+                    if snum > last_season or (snum == last_season and enum > last_episode):
+                        last_season = snum
+                        last_episode = enum
+                if max_ep > 0:
+                    seasons_watched[snum] = max_ep
+            if title:
+                result.append(TraktItem(
+                    title=title, year=year, media_type="episode",
+                    ids=ids, season=last_season, episode=last_episode,
+                    seasons_watched=seasons_watched,
+                ))
+        self._do_log(f"get_watched_shows: {len(result)} Serien")
+        return result
+
     # -------------------------------------------------------------------
     # Calendar
     # -------------------------------------------------------------------
@@ -427,6 +470,21 @@ class TraktClient:
         ids = show.get("ids") or {}
         return str(ids.get("slug") or ids.get("trakt") or "")
 
+    def search_show_ids(self, query: str) -> "tuple[int, str]":
+        """GET /search/show?query=... – gibt (tmdb_id, imdb_id) des ersten Treffers zurück.
+        Fallback wenn TMDB keine IDs liefert.
+        """
+        from urllib.parse import urlencode
+        path = f"/search/show?{urlencode({'query': query, 'limit': 1})}"
+        status, payload = self._get(path)
+        if status != 200 or not isinstance(payload, list) or not payload:
+            return 0, ""
+        show = (payload[0] or {}).get("show") or {}
+        ids = show.get("ids") or {}
+        tmdb_id = int(ids.get("tmdb") or 0)
+        imdb_id = str(ids.get("imdb") or "")
+        return tmdb_id, imdb_id
+
     def lookup_tv_season(
         self,
         show_id_or_slug: "str | int",

addon/default.py

@@ -117,11 +117,25 @@ from metadata_utils import (
     needs_tmdb as _needs_tmdb,
 )
 from tmdb import TmdbCastMember, TmdbExternalIds, fetch_external_ids, fetch_tv_episode_credits, lookup_movie, lookup_tv_season, lookup_tv_season_summary, lookup_tv_show
+from core.metadata import _resolve_tmdb_api_key
 from core.router import Router
 
 _router = Router()
 
 PLUGIN_DIR = Path(__file__).with_name("plugins")
+_PICTURES_DIR = Path(__file__).parent / "pictures"
+_MENU_ICONS: dict[str, str] = {
+    "search":         str(_PICTURES_DIR / "suche.png"),
+    "plugin_search":  str(_PICTURES_DIR / "suche.png"),
+    "genres":         str(_PICTURES_DIR / "generes.png"),
+    "alpha_index":    str(_PICTURES_DIR / "a_z.png"),
+    "series_catalog": str(_PICTURES_DIR / "serien.png"),
+    "settings":       str(_PICTURES_DIR / "einstellung.png"),
+    "trakt_menu":     str(_PICTURES_DIR / "seriensammlung.png"),
+    "trakt_continue": str(_PICTURES_DIR / "hgesehn.png"),
+    "latest_titles":  str(_PICTURES_DIR / "neuste.png"),
+}
+
 _PLUGIN_CACHE: dict[str, BasisPlugin] | None = None
 _TMDB_CACHE: dict[str, tuple[dict[str, str], dict[str, str]]] = {}
 _TMDB_CAST_CACHE: dict[str, list[TmdbCastMember]] = {}
@@ -132,6 +146,8 @@ _TMDB_SEASON_CACHE: dict[tuple[int, int, str, str], dict[int, tuple[dict[str, st
 _TMDB_SEASON_SUMMARY_CACHE: dict[tuple[int, int, str, str], tuple[dict[str, str], dict[str, str]]] = {}
 _TMDB_EPISODE_CAST_CACHE: dict[tuple[int, int, int, str], list[TmdbCastMember]] = {}
 _TRAKT_SEASON_META_CACHE: dict = {}
+_TRAKT_SEASON_META_CACHE_TS: float = 0.0
+_TRAKT_SEASON_META_CACHE_TTL: int = 1800  # 30 Minuten
 _TMDB_LOG_PATH: str | None = None
 _GENRE_TITLES_CACHE: dict[tuple[str, str], list[str]] = {}
 _ADDON_INSTANCE = None
@@ -177,7 +193,7 @@ def _fetch_and_cache_imdb_id(title_key: str, tmdb_id: int, kind: str) -> str:
     cached = _tmdb_cache_get(_IMDB_ID_CACHE, title_key)
     if cached is not None:
         return cached
-    api_key = _get_setting_string("tmdb_api_key").strip()
+    api_key = _resolve_tmdb_api_key(_get_setting_string("tmdb_api_key").strip())
     if not api_key or api_key == "None" or not tmdb_id:
         return ""
     ext = fetch_external_ids(kind=kind, tmdb_id=tmdb_id, api_key=api_key)
@@ -602,6 +618,20 @@ def _get_setting_int(setting_id: str, *, default: int = 0) -> int:
     return default
 
 
+_PREFERRED_HOSTERS_LIST = [
+    "voe", "streamtape", "doodstream", "vidoza", "mixdrop", "supervideo", "dropload",
+]
+
+
+def _get_preferred_hoster() -> str:
+    """Liest preferred_hoster (enum-Index) und gibt den Hosternamen zurueck."""
+    raw = _get_setting_string("preferred_hoster").strip()
+    try:
+        return _PREFERRED_HOSTERS_LIST[int(raw)]
+    except (ValueError, IndexError):
+        return raw  # Fallback: Textwert direkt verwenden
+
+
 def _metadata_policy(
     plugin_name: str,
     plugin: BasisPlugin,
@@ -854,7 +884,7 @@ def _tmdb_labels_and_art(title: str) -> tuple[dict[str, str], dict[str, str], li
     art: dict[str, str] = {}
     cast: list[TmdbCastMember] = []
     query = (title or "").strip()
-    api_key = _get_setting_string("tmdb_api_key").strip()
+    api_key = _resolve_tmdb_api_key(_get_setting_string("tmdb_api_key").strip())
     log_requests = _get_setting_bool("tmdb_log_requests", default=False)
     log_responses = _get_setting_bool("tmdb_log_responses", default=False)
     if api_key and api_key != "None":
@@ -1004,7 +1034,7 @@ def _tmdb_episode_labels_and_art(*, title: str, season_label: str, episode_label
     season_key = (tmdb_id, season_number, language, flags)
     cached_season = _tmdb_cache_get(_TMDB_SEASON_CACHE, season_key)
     if cached_season is None:
-        api_key = _get_setting_string("tmdb_api_key").strip()
+        api_key = _resolve_tmdb_api_key(_get_setting_string("tmdb_api_key").strip())
         if not api_key or api_key == "None":
             return _trakt_episode_labels_and_art(
                 title=title, season_label=season_label, episode_label=episode_label
@@ -1050,6 +1080,12 @@ def _trakt_episode_labels_and_art(
     Lädt Staffel-Episodendaten per Batch (extended=full,images) und optionale
     deutsche Übersetzung per Episode (Translations-Endpunkt).
     """
+    global _TRAKT_SEASON_META_CACHE_TS
+    now = time.time()
+    if now - _TRAKT_SEASON_META_CACHE_TS > _TRAKT_SEASON_META_CACHE_TTL:
+        _TRAKT_SEASON_META_CACHE.clear()
+        _TRAKT_SEASON_META_CACHE_TS = now
+
     client = _trakt_get_client()
     if not client:
         return {"title": episode_label}, {}
@@ -1129,7 +1165,7 @@ def _tmdb_episode_cast(*, title: str, season_label: str, episode_label: str) ->
     if cached is not None:
         return list(cached)
 
-    api_key = _get_setting_string("tmdb_api_key").strip()
+    api_key = _resolve_tmdb_api_key(_get_setting_string("tmdb_api_key").strip())
     if not api_key or api_key == "None":
         _tmdb_cache_set(_TMDB_EPISODE_CAST_CACHE, cache_key, [])
         return []
@@ -1157,6 +1193,11 @@ def _tmdb_episode_cast(*, title: str, season_label: str, episode_label: str) ->
     return list(cast)
 
 
+def _icon_for(action: str) -> dict[str, str] | None:
+    path = _MENU_ICONS.get(action)
+    return {"icon": path, "thumb": path} if path else None
+
+
 def _add_directory_item(
     handle: int,
     label: str,
@@ -1216,6 +1257,8 @@ UPDATE_ADDON_ID = "plugin.video.viewit"
 RESOLVEURL_ADDON_ID = "script.module.resolveurl"
 RESOLVEURL_AUTO_INSTALL_INTERVAL_SEC = 6 * 60 * 60
 YTDLP_ADDON_ID = "script.module.yt-dlp"
+TMDB_HELPER_ADDON_ID = "plugin.video.themoviedb.helper"
+TMDB_HELPER_PLAYERS_DIR = Path.home() / ".kodi" / "addons" / TMDB_HELPER_ADDON_ID / "resources" / "players"
 
 
 def _selected_update_channel() -> int:
@@ -1535,6 +1578,11 @@ def _install_addon_version(info_url: str, version: str) -> bool:
     return _install_addon_version_manual(info_url, version)
 
 
+def _sync_trakt_status_setting() -> None:
+    connected = bool(_trakt_load_token())
+    _get_addon().setSetting("trakt_status", "Verbunden" if connected else "Nicht verbunden")
+
+
 def _sync_update_channel_status_settings() -> None:
     channel = _selected_update_channel()
     selected_info_url = _resolve_update_info_url()
@@ -1689,7 +1737,6 @@ def _maybe_auto_install_resolveurl(action: str | None) -> None:
 
 
 def _sync_tmdb_active_key_setting() -> None:
-    from core.metadata import _resolve_tmdb_api_key
     raw_key = _get_setting_string("tmdb_api_key").strip()
     active_key = _resolve_tmdb_api_key(raw_key)
     if active_key:
@@ -1704,6 +1751,34 @@ def _sync_ytdlp_status_setting() -> None:
     _set_setting_string("ytdlp_status", status)
 
 
+def _sync_tmdb_helper_status_setting() -> None:
+    status = "Installiert" if _is_addon_installed(TMDB_HELPER_ADDON_ID) else "Nicht installiert"
+    _set_setting_string("tmdb_helper_status", status)
+
+
+_TMDB_HELPER_PLAYERS_SOURCE = Path(__file__).parent / "resources" / "players"
+
+
+def _install_tmdb_helper_players() -> None:
+    if not _is_addon_installed(TMDB_HELPER_ADDON_ID):
+        xbmcgui.Dialog().notification("TMDb Helper", "TMDb Helper ist nicht installiert.", xbmcgui.NOTIFICATION_WARNING, 4000)
+        return
+    try:
+        source_files = list(_TMDB_HELPER_PLAYERS_SOURCE.glob("*.json"))
+        if not source_files:
+            xbmcgui.Dialog().notification("TMDb Helper", "Keine Player-Dateien gefunden.", xbmcgui.NOTIFICATION_WARNING, 4000)
+            return
+        TMDB_HELPER_PLAYERS_DIR.mkdir(parents=True, exist_ok=True)
+        import shutil
+        for src in source_files:
+            shutil.copy2(src, TMDB_HELPER_PLAYERS_DIR / src.name)
+        _log(f"TMDb Helper Player installiert: {[f.name for f in source_files]}")
+        xbmcgui.Dialog().notification("TMDb Helper", f"{len(source_files)} Player installiert.", xbmcgui.NOTIFICATION_INFO, 3000)
+    except Exception as exc:
+        _log(f"TMDb Helper Player Installation fehlgeschlagen: {exc}", xbmc.LOGWARNING)
+        xbmcgui.Dialog().notification("TMDb Helper", f"Fehler: {exc}", xbmcgui.NOTIFICATION_ERROR, 5000)
+
+
 def _fetch_ytdlp_zip_url() -> str:
     """Ermittelt die aktuellste ZIP-URL fuer script.module.yt-dlp von GitHub."""
     api_url = "https://api.github.com/repos/lekma/script.module.yt-dlp/releases/latest"
@@ -1800,6 +1875,7 @@ def _sync_update_version_settings() -> None:
     _set_setting_string("update_installed_version", addon_version)
     _sync_resolveurl_status_setting()
     _sync_ytdlp_status_setting()
+    _sync_tmdb_helper_status_setting()
     _sync_update_channel_status_settings()
     _sync_tmdb_active_key_setting()
 
@@ -1811,14 +1887,14 @@ def _show_root_menu() -> None:
     # Update-Hinweis ganz oben wenn neuere Version verfügbar
     installed = _get_setting_string("update_installed_version").strip()
     available = _get_setting_string("update_available_selected").strip()
-    if installed and available and available not in ("-", "", "0.0.0") and installed != available:
+    if installed and available and available not in ("-", "", "0.0.0") and _version_sort_key(available) > _version_sort_key(installed):
         _add_directory_item(
             handle,
             f"Update verfuegbar: {installed} -> {available}",
             "select_update_version",
         )
 
-    _add_directory_item(handle, "Suche in allen Quellen", "search")
+    _add_directory_item(handle, "Suche in allen Quellen", "search", art=_icon_for("search"))
 
     plugins = _discover_plugins()
     for plugin_name in sorted(plugins.keys(), key=lambda value: value.casefold()):
@@ -1826,15 +1902,22 @@ def _show_root_menu() -> None:
 
     # Trakt-Menue (nur wenn aktiviert)
     if _get_setting_bool("trakt_enabled", default=False):
-        if _trakt_load_token():
-            _add_directory_item(handle, "Weiterschauen", "trakt_continue", is_folder=True)
-            _add_directory_item(handle, "Trakt Upcoming", "trakt_upcoming", is_folder=True)
-            _add_directory_item(handle, "Trakt Watchlist", "trakt_watchlist", is_folder=True)
-            _add_directory_item(handle, "Trakt History", "trakt_history", {"page": "1"}, is_folder=True)
-        else:
-            _add_directory_item(handle, "Trakt autorisieren", "trakt_auth", is_folder=True)
+        _add_directory_item(handle, "Trakt", "trakt_menu", is_folder=True, art=_icon_for("trakt_menu"))
 
-    _add_directory_item(handle, "Einstellungen", "settings")
+    _add_directory_item(handle, "Einstellungen", "settings", art=_icon_for("settings"))
+    xbmcplugin.endOfDirectory(handle)
+
+
+def _show_trakt_menu() -> None:
+    handle = _get_handle()
+    xbmcplugin.setPluginCategory(handle, "Trakt")
+    if _trakt_load_token():
+        _add_directory_item(handle, "Weiterschauen", "trakt_continue", is_folder=True, art=_icon_for("trakt_continue"))
+        _add_directory_item(handle, "Trakt Upcoming", "trakt_upcoming", is_folder=True)
+        _add_directory_item(handle, "Trakt Watchlist", "trakt_watchlist", is_folder=True)
+        _add_directory_item(handle, "Trakt History", "trakt_history", {"page": "1"}, is_folder=True)
+    else:
+        _add_directory_item(handle, "Trakt autorisieren", "trakt_auth", is_folder=True)
     xbmcplugin.endOfDirectory(handle)
 
 
@@ -1850,19 +1933,19 @@ def _show_plugin_menu(plugin_name: str) -> None:
     xbmcplugin.setPluginCategory(handle, plugin_name)
 
     if callable(getattr(plugin, "search_titles", None)):
-        _add_directory_item(handle, "Suche", "plugin_search", {"plugin": plugin_name}, is_folder=True)
+        _add_directory_item(handle, "Suche", "plugin_search", {"plugin": plugin_name}, is_folder=True, art=_icon_for("plugin_search"))
 
     if _plugin_has_capability(plugin, "new_titles") or _plugin_has_capability(plugin, "latest_episodes"):
-        _add_directory_item(handle, LATEST_MENU_LABEL, "latest_titles", {"plugin": plugin_name, "page": "1"}, is_folder=True)
+        _add_directory_item(handle, LATEST_MENU_LABEL, "latest_titles", {"plugin": plugin_name, "page": "1"}, is_folder=True, art=_icon_for("latest_titles"))
 
     if _plugin_has_capability(plugin, "genres"):
-        _add_directory_item(handle, "Genres", "genres", {"plugin": plugin_name}, is_folder=True)
+        _add_directory_item(handle, "Genres", "genres", {"plugin": plugin_name}, is_folder=True, art=_icon_for("genres"))
 
     if _plugin_has_capability(plugin, "alpha"):
-        _add_directory_item(handle, "A-Z", "alpha_index", {"plugin": plugin_name}, is_folder=True)
+        _add_directory_item(handle, "A-Z", "alpha_index", {"plugin": plugin_name}, is_folder=True, art=_icon_for("alpha_index"))
 
     if _plugin_has_capability(plugin, "series_catalog"):
-        _add_directory_item(handle, "Serien", "series_catalog", {"plugin": plugin_name, "page": "1"}, is_folder=True)
+        _add_directory_item(handle, "Serien", "series_catalog", {"plugin": plugin_name, "page": "1"}, is_folder=True, art=_icon_for("series_catalog"))
 
     if _plugin_has_capability(plugin, "popular_series"):
         _add_directory_item(handle, POPULAR_MENU_LABEL, "popular", {"plugin": plugin_name, "page": "1"}, is_folder=True)
@@ -1885,7 +1968,7 @@ def _show_plugin_menu(plugin_name: str) -> None:
     xbmcplugin.endOfDirectory(handle)
 
 
-def _show_plugin_search(plugin_name: str) -> None:
+def _show_plugin_search(plugin_name: str, query: str = "") -> None:
     plugin_name = (plugin_name or "").strip()
     plugin = _discover_plugins().get(plugin_name)
     if not plugin:
@@ -1893,13 +1976,15 @@ def _show_plugin_search(plugin_name: str) -> None:
         _show_root_menu()
         return
 
-    _log(f"Plugin-Suche gestartet: {plugin_name}")
-    dialog = xbmcgui.Dialog()
-    query = dialog.input(f"{plugin_name}: Titel eingeben", type=xbmcgui.INPUT_ALPHANUM).strip()
+    query = (query or "").strip()
     if not query:
-        _log("Plugin-Suche abgebrochen (leere Eingabe).", xbmc.LOGDEBUG)
-        _show_plugin_menu(plugin_name)
-        return
+        _log(f"Plugin-Suche gestartet: {plugin_name}")
+        dialog = xbmcgui.Dialog()
+        query = dialog.input(f"{plugin_name}: Titel eingeben", type=xbmcgui.INPUT_ALPHANUM).strip()
+        if not query:
+            _log("Plugin-Suche abgebrochen (leere Eingabe).", xbmc.LOGDEBUG)
+            _show_plugin_menu(plugin_name)
+            return
     _log(f"Plugin-Suchbegriff ({plugin_name}): {query}", xbmc.LOGDEBUG)
     _show_plugin_search_results(plugin_name, query)
 
@@ -1938,6 +2023,8 @@ def _show_plugin_search_results(plugin_name: str, query: str) -> None:
                         pass
                 raise
             results = _clean_search_titles([str(t).strip() for t in (results or []) if t and str(t).strip()])
+            from search_utils import matches_query as _mq
+            results = [r for r in results if _mq(query, title=r)]
             results.sort(key=lambda value: value.casefold())
 
             use_source, show_tmdb, prefer_source = _metadata_policy(
@@ -2093,8 +2180,17 @@ def _run_async(coro):
     """Fuehrt eine Coroutine aus, auch wenn Kodi bereits einen Event-Loop hat."""
     _ensure_windows_selector_policy()
 
-    def _run_with_asyncio_run():
-        return asyncio.run(coro)
+    def _run_without_asyncio_run():
+        # asyncio.run() wuerde cancel_all_tasks() aufrufen, was auf Android TV
+        # wegen eines kaputten _weakrefset.py-Builds zu NameError: 'len' fuehrt.
+        loop = asyncio.new_event_loop()
+        try:
+            return loop.run_until_complete(coro)
+        finally:
+            try:
+                loop.close()
+            except Exception:
+                pass
 
     try:
         running_loop = asyncio.get_running_loop()
@@ -2107,7 +2203,7 @@ def _run_async(coro):
 
         def _worker() -> None:
             try:
-                result_box["value"] = _run_with_asyncio_run()
+                result_box["value"] = _run_without_asyncio_run()
             except BaseException as exc:  # pragma: no cover - defensive
                 error_box["error"] = exc
 
@@ -2118,7 +2214,7 @@ def _run_async(coro):
             raise error_box["error"]
         return result_box.get("value")
 
-    return _run_with_asyncio_run()
+    return _run_without_asyncio_run()
 
 
 def _series_url_params(plugin: BasisPlugin, title: str) -> dict[str, str]:
@@ -2159,6 +2255,29 @@ def _clean_search_titles(values: list[str]) -> list[str]:
     return cleaned
 
 
+_SEARCH_PLUGIN_SETTING_IDS: dict[str, str] = {
+    "Serienstream":  "search_plugin_serienstream",
+    "Aniworld":      "search_plugin_aniworld",
+    "Topstreamfilm": "search_plugin_topstreamfilm",
+    "Filmpalast":    "search_plugin_filmpalast",
+    "Moflix":        "search_plugin_moflix",
+    "KKiste":        "search_plugin_kkiste",
+    "HDFilme":       "search_plugin_hdfilme",
+    "Einschalten":   "search_plugin_einschalten",
+    "Doku-Streams":  "search_plugin_doku_streams",
+    "NetzkKino":     "search_plugin_netzkino",
+    "YouTube":       "search_plugin_youtube",
+}
+
+
+def _plugin_search_enabled(plugin_name: str) -> bool:
+    """Gibt True zurück wenn das Plugin in der globalen Suche aktiv ist."""
+    setting_id = _SEARCH_PLUGIN_SETTING_IDS.get(plugin_name)
+    if setting_id is None:
+        return True  # unbekannte Plugins standardmäßig einschließen
+    return _get_setting_bool(setting_id, default=True)
+
+
 def _show_search() -> None:
     _log("Suche gestartet.")
     dialog = xbmcgui.Dialog()
@@ -2183,7 +2302,7 @@ def _show_search_results(query: str) -> None:
     # grouped: casefold-key → Liste der Plugin-Einträge für diesen Titel
     grouped: dict[str, list[dict[str, object]]] = {}
     canceled = False
-    plugin_entries = list(plugins.items())
+    plugin_entries = [(n, p) for n, p in plugins.items() if _plugin_search_enabled(n)]
     total_plugins = max(1, len(plugin_entries))
     with _progress_dialog("Suche laeuft", "Suche startet...") as progress:
         for plugin_index, (plugin_name, plugin) in enumerate(plugin_entries, start=1):
@@ -2208,6 +2327,8 @@ def _show_search_results(query: str) -> None:
                 _log(f"Suche fehlgeschlagen ({plugin_name}): {exc}", xbmc.LOGWARNING)
                 continue
             results = _clean_search_titles([str(t).strip() for t in (results or []) if t and str(t).strip()])
+            from search_utils import matches_query as _mq
+            results = [r for r in results if _mq(query, title=r)]
             _log(f"Treffer ({plugin_name}): {len(results)}", xbmc.LOGDEBUG)
             use_source, show_tmdb, prefer_source = _metadata_policy(
                 plugin_name, plugin, allow_tmdb=_tmdb_enabled()
@@ -2286,7 +2407,7 @@ def _show_search_results(query: str) -> None:
             # Nur ein Plugin → direkt zur Staffel-Ansicht
             direct_play = bool(first["direct_play"])
             list_items.append({
-                "label": first["label_base"],
+                "label": f"{first['label_base']} [{first['plugin_name']}]",
                 "action": "play_movie" if direct_play else "seasons",
                 "params": {"plugin": first["plugin_name"], "title": canonical_title, **dict(first["extra_params"])},
                 "is_folder": not direct_play,
@@ -2297,8 +2418,9 @@ def _show_search_results(query: str) -> None:
         else:
             # Mehrere Plugins → Zwischenstufe "Quelle wählen"
             plugin_list = ",".join(str(e["plugin_name"]) for e in entries)
+            provider_label = ", ".join(str(e["plugin_name"]) for e in entries)
             list_items.append({
-                "label": first["label_base"],
+                "label": f"{first['label_base']} [{provider_label}]",
                 "action": "choose_source",
                 "params": {"title": canonical_title, "plugins": plugin_list},
                 "is_folder": True,
@@ -2485,7 +2607,7 @@ def _show_seasons(plugin_name: str, title: str, series_url: str = "") -> None:
     # Staffel-Metadaten (Plot/Poster) optional via TMDB.
     if show_tmdb:
         _tmdb_labels_and_art(title)
-    api_key = _get_setting_string("tmdb_api_key").strip() if show_tmdb else ""
+    api_key = _resolve_tmdb_api_key(_get_setting_string("tmdb_api_key").strip()) if show_tmdb else ""
     language = _get_setting_string("tmdb_language").strip() or "de-DE"
     show_plot = _get_setting_bool("tmdb_show_plot", default=True)
     show_art = _get_setting_bool("tmdb_show_art", default=True)
@@ -3473,6 +3595,8 @@ def _show_latest_episodes(plugin_name: str, page: int = 1) -> None:
         xbmcplugin.endOfDirectory(handle)
         return
 
+    # Unique Serientitel für Metadaten-Prefetch sammeln
+    valid_entries = []
     for entry in entries:
         try:
             title = str(getattr(entry, "series_title", "") or "").strip()
@@ -3484,7 +3608,28 @@ def _show_latest_episodes(plugin_name: str, page: int = 1) -> None:
             continue
         if not title or not url or season_number < 0 or episode_number <= 0:
             continue
+        valid_entries.append((title, season_number, episode_number, url, airdate))
 
+    unique_titles = list(dict.fromkeys(t for t, *_ in valid_entries))
+    use_source, show_tmdb, prefer_source = _metadata_policy(
+        plugin_name, plugin, allow_tmdb=_tmdb_enabled()
+    )
+    plugin_meta = _collect_plugin_metadata(plugin, unique_titles) if use_source else {}
+    show_plot = _get_setting_bool("tmdb_show_plot", default=True)
+    show_art = _get_setting_bool("tmdb_show_art", default=True)
+    tmdb_prefetched: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember]]] = {}
+    tmdb_titles = list(unique_titles) if show_tmdb else []
+    if show_tmdb and prefer_source and use_source:
+        tmdb_titles = [t for t in unique_titles if _needs_tmdb(
+            (plugin_meta.get(t) or ({}, {}))[0],
+            (plugin_meta.get(t) or ({}, {}))[1],
+            want_plot=show_plot, want_art=show_art,
+        )]
+    if show_tmdb and tmdb_titles:
+        with _busy_dialog(f"{LATEST_MENU_LABEL} wird geladen..."):
+            tmdb_prefetched = _tmdb_labels_and_art_bulk(tmdb_titles)
+
+    for title, season_number, episode_number, url, airdate in valid_entries:
         season_label = f"Staffel {season_number}"
         episode_label = f"Episode {episode_number}"
         key = _playstate_key(plugin_name=plugin_name, title=title, season=season_label, episode=episode_label)
@@ -3493,13 +3638,20 @@ def _show_latest_episodes(plugin_name: str, page: int = 1) -> None:
         label = f"{title} - S{season_number:02d}E{episode_number:02d}"
         label = _label_with_playstate(label, playstate)
 
-        info_labels: dict[str, object] = {
+        tmdb_info, tmdb_art, tmdb_cast = tmdb_prefetched.get(title, ({}, {}, [])) if show_tmdb else ({}, {}, [])
+        meta = plugin_meta.get(title)
+        merged_labels, art, cast = _merge_metadata(title, tmdb_info, tmdb_art, tmdb_cast, meta)
+
+        info_labels: dict[str, object] = dict(merged_labels or {})
+        info_labels.update({
             "title": f"{title} - S{season_number:02d}E{episode_number:02d}",
             "tvshowtitle": title,
             "season": season_number,
             "episode": episode_number,
             "mediatype": "episode",
-        }
+        })
+        if airdate:
+            info_labels.setdefault("aired", airdate)
         info_labels = _apply_playstate_to_info(info_labels, playstate)
 
         _add_directory_item(
@@ -3515,6 +3667,8 @@ def _show_latest_episodes(plugin_name: str, page: int = 1) -> None:
             },
             is_folder=False,
             info_labels=info_labels,
+            art=art,
+            cast=cast,
         )
 
     has_more_fn = getattr(plugin, "latest_episodes_has_more", None)
@@ -4248,8 +4402,10 @@ def _trakt_scrobble_start_async(media: dict[str, object]) -> None:
     threading.Thread(target=_do, daemon=True).start()
 
 
-def _trakt_scrobble_stop_async(media: dict[str, object], progress: float = 100.0) -> None:
-    """Sendet scrobble/stop an die Trakt-API in einem Hintergrund-Thread."""
+def _trakt_scrobble_stop_async(media: dict[str, object], progress: float = 100.0) -> threading.Thread:
+    """Sendet scrobble/stop an die Trakt-API in einem Hintergrund-Thread.
+    Gibt den Thread zurück damit der Aufrufer bei Bedarf darauf warten kann.
+    """
     def _do() -> None:
         try:
             from core.trakt import TraktClient
@@ -4270,7 +4426,9 @@ def _trakt_scrobble_stop_async(media: dict[str, object], progress: float = 100.0
             progress=progress,
         )
         _log(f"Trakt scrobble/stop: {media.get('title')} progress={progress:.0f}%", xbmc.LOGDEBUG)
-    threading.Thread(target=_do, daemon=True).start()
+    t = threading.Thread(target=_do, daemon=True)
+    t.start()
+    return t
 
 
 def _trakt_monitor_playback(media: dict[str, object]) -> None:
@@ -4312,9 +4470,18 @@ def _trakt_monitor_playback(media: dict[str, object]) -> None:
     if monitor.abortRequested():
         return
 
-    progress = min(100.0, (last_pos / total_time * 100.0)) if total_time > 0 else 100.0
+    if total_time > 0:
+        progress = min(100.0, last_pos / total_time * 100.0)
+    elif last_pos > 0:
+        # Keine Gesamtlaufzeit bekannt – kein Scrobble um falsche 100%-Markierung zu vermeiden
+        _log("Trakt monitor: total_time unbekannt, kein Scrobble.", xbmc.LOGDEBUG)
+        return
+    else:
+        _log("Trakt monitor: keine Positionsdaten, kein Scrobble.", xbmc.LOGDEBUG)
+        return
     _log(f"Trakt monitor: Wiedergabe beendet, progress={progress:.0f}%", xbmc.LOGDEBUG)
-    _trakt_scrobble_stop_async(media, progress=progress)
+    stop_thread = _trakt_scrobble_stop_async(media, progress=progress)
+    stop_thread.join(timeout=10)
 
 
 def _track_playback_and_update_state_async(key: str) -> None:
@@ -4375,7 +4542,7 @@ def _play_episode(
     selected_hoster: str | None = None
     forced_hoster = (forced_hoster or "").strip()
     autoplay = _get_setting_bool("autoplay_enabled", default=False)
-    preferred = _get_setting_string("preferred_hoster").strip()
+    preferred = _get_preferred_hoster()
     if available_hosters:
         if forced_hoster:
             for hoster in available_hosters:
@@ -4410,13 +4577,15 @@ def _play_episode(
         preferred_setter([selected_hoster])
 
     try:
-        link = plugin.stream_link_for(title, season, episode)
+        with _busy_dialog("Stream wird gesucht..."):
+            link = plugin.stream_link_for(title, season, episode)
         if not link:
             _log("Kein Stream gefunden.", xbmc.LOGWARNING)
             xbmcgui.Dialog().notification("Wiedergabe", "Kein Stream gefunden.", xbmcgui.NOTIFICATION_INFO, 3000)
             return
         _log(f"Stream-Link: {link}", xbmc.LOGDEBUG)
-        final_link = _resolve_stream_with_retry(plugin, link)
+        with _busy_dialog("Stream wird aufgelöst..."):
+            final_link = _resolve_stream_with_retry(plugin, link)
         if not final_link:
             return
     finally:
@@ -4441,6 +4610,15 @@ def _play_episode(
     if _tmdb_id:
         _imdb_id = _fetch_and_cache_imdb_id(title_key, _tmdb_id, _kind)
         _set_trakt_ids_property(title, _tmdb_id, _imdb_id)
+    if not _tmdb_id and not _imdb_id and _get_setting_bool("trakt_enabled", default=False):
+        # Fallback: Trakt-Titelsuche wenn TMDB keine IDs liefert
+        try:
+            _trakt_client = _trakt_get_client()
+            if _trakt_client:
+                _tmdb_id, _imdb_id = _trakt_client.search_show_ids(title)
+                _log(f"Trakt ID-Fallback fuer '{title}': tmdb={_tmdb_id} imdb={_imdb_id}", xbmc.LOGDEBUG)
+        except Exception:
+            pass
     trakt_media: dict[str, object] = {
         "title": title, "tmdb_id": _tmdb_id, "imdb_id": _imdb_id, "kind": _kind,
         "season": season_number or 0, "episode": episode_number or 0,
@@ -4492,7 +4670,7 @@ def _play_episode_url(
 
     selected_hoster: str | None = None
     autoplay = _get_setting_bool("autoplay_enabled", default=False)
-    preferred = _get_setting_string("preferred_hoster").strip()
+    preferred = _get_preferred_hoster()
     if available_hosters:
         if autoplay and preferred:
             pref_lower = preferred.casefold()
@@ -4750,13 +4928,33 @@ def _show_collection_titles_page(plugin_name: str, collection: str, page: int =
         xbmcplugin.endOfDirectory(handle)
         return
     titles = [str(t).strip() for t in titles if t and str(t).strip()]
-    direct_play = bool(plugin_name.casefold() == "einschalten"
-                       and _get_setting_bool("einschalten_enable_playback", default=False))
-    for title in titles:
-        _add_directory_item(handle, title, "play_movie" if direct_play else "seasons",
-                            {"plugin": plugin_name, "title": title, **_series_url_params(plugin, title)},
-                            is_folder=not direct_play)
     if titles:
+        use_source, show_tmdb, prefer_source = _metadata_policy(
+            plugin_name, plugin, allow_tmdb=_tmdb_list_enabled()
+        )
+        plugin_meta = _collect_plugin_metadata(plugin, titles) if use_source else {}
+        show_plot = _get_setting_bool("tmdb_show_plot", default=True)
+        show_art = _get_setting_bool("tmdb_show_art", default=True)
+        tmdb_prefetched: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember]]] = {}
+        tmdb_titles = list(titles) if show_tmdb else []
+        if show_tmdb and prefer_source and use_source:
+            tmdb_titles = [
+                t for t in titles
+                if _needs_tmdb((plugin_meta.get(t) or ({},))[0], (plugin_meta.get(t) or ({}, {}))[1],
+                               want_plot=show_plot, want_art=show_art)
+            ]
+        if show_tmdb and tmdb_titles:
+            with _busy_dialog(f"{collection} wird geladen..."):
+                tmdb_prefetched = _tmdb_labels_and_art_bulk(tmdb_titles)
+        for title in titles:
+            tmdb_info, tmdb_art, tmdb_cast = tmdb_prefetched.get(title, ({}, {}, [])) if show_tmdb else ({}, {}, [])
+            meta = plugin_meta.get(title)
+            info_labels, art, cast = _merge_metadata(title, tmdb_info, tmdb_art, tmdb_cast, meta)
+            info_labels = dict(info_labels or {})
+            info_labels.setdefault("mediatype", "tvshow")
+            _add_directory_item(handle, title, "seasons",
+                                {"plugin": plugin_name, "title": title, **_series_url_params(plugin, title)},
+                                is_folder=True, info_labels=info_labels, art=art, cast=cast)
         _add_directory_item(handle, "Naechste Seite", "collection_titles_page",
                             {"plugin": plugin_name, "collection": collection, "page": str(page + 1)}, is_folder=True)
     xbmcplugin.endOfDirectory(handle)
@@ -4811,11 +5009,33 @@ def _show_tag_titles_page(plugin_name: str, tag: str, page: int = 1) -> None:
         xbmcplugin.endOfDirectory(handle)
         return
     titles = [str(t).strip() for t in titles if t and str(t).strip()]
-    for title in titles:
-        _add_directory_item(handle, title, "seasons",
-                            {"plugin": plugin_name, "title": title, **_series_url_params(plugin, title)},
-                            is_folder=True)
     if titles:
+        use_source, show_tmdb, prefer_source = _metadata_policy(
+            plugin_name, plugin, allow_tmdb=_tmdb_list_enabled()
+        )
+        plugin_meta = _collect_plugin_metadata(plugin, titles) if use_source else {}
+        show_plot = _get_setting_bool("tmdb_show_plot", default=True)
+        show_art = _get_setting_bool("tmdb_show_art", default=True)
+        tmdb_prefetched: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember]]] = {}
+        tmdb_titles = list(titles) if show_tmdb else []
+        if show_tmdb and prefer_source and use_source:
+            tmdb_titles = [
+                t for t in titles
+                if _needs_tmdb((plugin_meta.get(t) or ({},))[0], (plugin_meta.get(t) or ({}, {}))[1],
+                               want_plot=show_plot, want_art=show_art)
+            ]
+        if show_tmdb and tmdb_titles:
+            with _busy_dialog("Schlagwort-Liste wird geladen..."):
+                tmdb_prefetched = _tmdb_labels_and_art_bulk(tmdb_titles)
+        for title in titles:
+            tmdb_info, tmdb_art, tmdb_cast = tmdb_prefetched.get(title, ({}, {}, [])) if show_tmdb else ({}, {}, [])
+            meta = plugin_meta.get(title)
+            info_labels, art, cast = _merge_metadata(title, tmdb_info, tmdb_art, tmdb_cast, meta)
+            info_labels = dict(info_labels or {})
+            info_labels.setdefault("mediatype", "tvshow")
+            _add_directory_item(handle, title, "seasons",
+                                {"plugin": plugin_name, "title": title, **_series_url_params(plugin, title)},
+                                is_folder=True, info_labels=info_labels, art=art, cast=cast)
         _add_directory_item(handle, "Naechste Seite", "tag_titles_page",
                             {"plugin": plugin_name, "tag": tag, "page": str(page + 1)}, is_folder=True)
     xbmcplugin.endOfDirectory(handle)
@@ -4910,10 +5130,11 @@ def _show_trakt_watchlist(media_type: str = "") -> None:
 
     _set_content(handle, "tvshows")
     items = client.get_watchlist(token, media_type=media_type)
+    tmdb_prefetched = _tmdb_labels_and_art_bulk([i.title for i in items]) if _tmdb_enabled() else {}
     for item in items:
         label = f"{item.title} ({item.year})" if item.year else item.title
 
-        tmdb_info, art, _ = _tmdb_labels_and_art(item.title)
+        tmdb_info, art, _ = tmdb_prefetched.get(item.title, ({}, {}, []))
         info_labels: dict[str, object] = dict(tmdb_info)
         info_labels["title"] = label
         info_labels["tvshowtitle"] = item.title
@@ -4921,19 +5142,10 @@ def _show_trakt_watchlist(media_type: str = "") -> None:
             info_labels["year"] = item.year
         info_labels["mediatype"] = "tvshow"
 
-        match = _trakt_find_in_plugins(item.title)
-        if match:
-            plugin_name, matched_title = match
-            action = "seasons"
-            params: dict[str, str] = {"plugin": plugin_name, "title": matched_title}
-        else:
-            action = "search"
-            params = {"query": item.title}
-
-        _add_directory_item(handle, label, action, params, is_folder=True, info_labels=info_labels, art=art)
+        _add_directory_item(handle, label, "search", {"query": item.title}, is_folder=True, info_labels=info_labels, art=art)
     if not items:
         xbmcgui.Dialog().notification("Trakt", "Watchlist ist leer.", xbmcgui.NOTIFICATION_INFO, 3000)
-    xbmcplugin.endOfDirectory(handle)
+    xbmcplugin.endOfDirectory(handle, cacheToDisc=False)
 
 
 def _show_trakt_history(page: int = 1) -> None:
@@ -4949,6 +5161,7 @@ def _show_trakt_history(page: int = 1) -> None:
     _set_content(handle, "episodes")
 
     items = client.get_history(token, page=page, limit=LIST_PAGE_SIZE)
+    tmdb_prefetched = _tmdb_labels_and_art_bulk(list(dict.fromkeys(i.title for i in items))) if _tmdb_enabled() else {}
     for item in items:
         is_episode = item.media_type == "episode" and item.season and item.episode
 
@@ -4969,7 +5182,7 @@ def _show_trakt_history(page: int = 1) -> None:
             art["fanart"] = item.show_fanart
         if item.show_poster:
             art["poster"] = item.show_poster
-        _, tmdb_art, _ = _tmdb_labels_and_art(item.title)
+        _, tmdb_art, _ = tmdb_prefetched.get(item.title, ({}, {}, []))
         for _k, _v in tmdb_art.items():
             art.setdefault(_k, _v)
 
@@ -4996,30 +5209,13 @@ def _show_trakt_history(page: int = 1) -> None:
                         f"RunPlugin({sys.argv[0]}?{wl_params})"))
 
         # Navigation: Episoden direkt abspielen, Serien zur Staffelauswahl
-        match = _trakt_find_in_plugins(item.title)
-        if match:
-            plugin_name, matched_title = match
-            if is_episode:
-                action = "play_episode"
-                params: dict[str, str] = {
-                    "plugin": plugin_name,
-                    "title": matched_title,
-                    "season": f"Staffel {item.season}",
-                    "episode": f"Episode {item.episode}",
-                }
-                _add_directory_item(handle, label, action, params, is_folder=False, info_labels=info_labels, art=art, context_menu=ctx or None)
-            else:
-                action = "seasons"
-                params = {"plugin": plugin_name, "title": matched_title}
-                _add_directory_item(handle, label, action, params, is_folder=True, info_labels=info_labels, art=art, context_menu=ctx or None)
-        else:
-            _add_directory_item(handle, label, "search", {"query": item.title}, is_folder=True, info_labels=info_labels, art=art, context_menu=ctx or None)
+        _add_directory_item(handle, label, "search", {"query": item.title}, is_folder=True, info_labels=info_labels, art=art, context_menu=ctx or None)
 
     if len(items) >= LIST_PAGE_SIZE:
         _add_directory_item(handle, "Naechste Seite >>", "trakt_history", {"page": str(page + 1)}, is_folder=True)
     if not items and page == 1:
         xbmcgui.Dialog().notification("Trakt", "Keine History vorhanden.", xbmcgui.NOTIFICATION_INFO, 3000)
-    xbmcplugin.endOfDirectory(handle)
+    xbmcplugin.endOfDirectory(handle, cacheToDisc=False)
 
 
 def _show_trakt_upcoming() -> None:
@@ -5066,6 +5262,10 @@ def _show_trakt_upcoming() -> None:
                 pass
         dated_items.append((airdate, item))
 
+    # TMDB-Artwork fuer alle Serien parallel prefetchen (dedupliziert)
+    show_titles = list(dict.fromkeys(item.show_title for _, item in dated_items))
+    tmdb_prefetched = _tmdb_labels_and_art_bulk(show_titles) if _tmdb_enabled() else {}
+
     last_date: _date | None = None
     for airdate, item in dated_items:
         # Datums-Ueberschrift einfuegen
@@ -5117,26 +5317,16 @@ def _show_trakt_upcoming() -> None:
             art["fanart"] = item.episode_thumb
         elif item.show_fanart:
             art["fanart"] = item.show_fanart
-        _, tmdb_art, _ = _tmdb_labels_and_art(item.show_title)
+        _, tmdb_art, _ = tmdb_prefetched.get(item.show_title, ({}, {}, []))
         for _k, _v in tmdb_art.items():
             art.setdefault(_k, _v)
 
-        match = _trakt_find_in_plugins(item.show_title)
-        if match:
-            plugin_name, matched_title = match
-            action = "episodes"
-            params: dict[str, str] = {
-                "plugin": plugin_name,
-                "title": matched_title,
-                "season": f"Staffel {item.season}",
-            }
-        else:
-            action = "search"
-            params = {"query": item.show_title}
+        action = "search"
+        params: dict[str, str] = {"query": item.show_title}
 
         _add_directory_item(handle, label, action, params, is_folder=True, info_labels=info_labels, art=art)
 
-    xbmcplugin.endOfDirectory(handle)
+    xbmcplugin.endOfDirectory(handle, cacheToDisc=False)
 
 
 def _show_trakt_continue_watching() -> None:
@@ -5153,65 +5343,41 @@ def _show_trakt_continue_watching() -> None:
     _set_content(handle, "episodes")
 
     try:
-        history = client.get_history(token, media_type="episodes", limit=100)
+        watched = client.get_watched_shows(token)
     except Exception as exc:
-        _log(f"Trakt History fehlgeschlagen: {exc}", xbmc.LOGWARNING)
-        xbmcgui.Dialog().notification("Trakt", "History konnte nicht geladen werden.", xbmcgui.NOTIFICATION_INFO, 3000)
+        _log(f"Trakt Watched fehlgeschlagen: {exc}", xbmc.LOGWARNING)
+        xbmcgui.Dialog().notification("Trakt", "Watched-Liste konnte nicht geladen werden.", xbmcgui.NOTIFICATION_INFO, 3000)
         xbmcplugin.endOfDirectory(handle)
         return
 
-    # Pro Serie nur den zuletzt gesehenen Eintrag behalten (History ist absteigend sortiert)
-    seen: dict[str, object] = {}
-    for item in history:
-        if item.title and item.title not in seen:
-            seen[item.title] = item
+    seen: dict[str, object] = {item.title: item for item in watched if item.title}
 
     if not seen:
-        xbmcgui.Dialog().notification("Trakt", "Keine History vorhanden.", xbmcgui.NOTIFICATION_INFO, 3000)
+        xbmcgui.Dialog().notification("Trakt", "Keine gesehenen Serien vorhanden.", xbmcgui.NOTIFICATION_INFO, 3000)
         xbmcplugin.endOfDirectory(handle)
         return
 
+    # TMDB-Artwork fuer alle Serien parallel prefetchen
+    tmdb_prefetched = _tmdb_labels_and_art_bulk(list(seen.keys())) if _tmdb_enabled() else {}
+
     for last in seen.values():
-        next_season = last.season
-        next_ep = last.episode + 1
-
-        match = _trakt_find_in_plugins(last.title)
-
-        # Wenn kein Plugin-Match: Suchaktion anbieten (kein Episode-Overflow-Problem)
-        if not match:
-            label = f"{last.title} \u2013 S{next_season:02d}E{next_ep:02d}"
-            sub = f"(zuletzt: S{last.season:02d}E{last.episode:02d})"
-            display_label = f"{label}  {sub}"
-            info_labels: dict[str, object] = {
-                "title": display_label,
-                "tvshowtitle": last.title,
-                "mediatype": "episode",
-            }
-            if last.year:
-                info_labels["year"] = last.year
-            _, art, _ = _tmdb_labels_and_art(last.title)
-            _add_directory_item(handle, display_label, "search", {"query": last.title}, is_folder=True, info_labels=info_labels, art=art)
-            continue
-
-        plugin_name, matched_title = match
-        # Prüfe ob die nächste Episode im Plugin tatsächlich existiert
-        plugin = _discover_plugins().get(plugin_name)
-        episodes_getter = getattr(plugin, "episodes_for_season", None) if plugin else None
-        if callable(episodes_getter):
-            try:
-                ep_list = episodes_getter(matched_title, next_season) or []
-                if next_ep > len(ep_list):
-                    # Letzte Folge der Staffel war die letzte – nächste Staffel, Folge 1
-                    next_season += 1
-                    next_ep = 1
-            except Exception:
-                pass
+        # Staffelwechsel erkennen: wenn last.episode die höchste gesehene Episode
+        # der aktuellen Staffel ist und eine höhere Staffel existiert → S+1 E01
+        seasons_watched: dict[int, int] = getattr(last, "seasons_watched", {})
+        max_ep_in_season = seasons_watched.get(last.season, 0)
+        next_seasons = sorted(s for s in seasons_watched if s > last.season)
+        if max_ep_in_season > 0 and last.episode >= max_ep_in_season and next_seasons:
+            next_season = next_seasons[0]
+            next_ep = 1
+        else:
+            next_season = last.season
+            next_ep = last.episode + 1
 
         label = f"{last.title} \u2013 S{next_season:02d}E{next_ep:02d}"
         sub = f"(zuletzt: S{last.season:02d}E{last.episode:02d})"
         display_label = f"{label}  {sub}"
 
-        info_labels = {
+        info_labels: dict[str, object] = {
             "title": display_label,
             "tvshowtitle": last.title,
             "season": next_season,
@@ -5221,16 +5387,10 @@ def _show_trakt_continue_watching() -> None:
         if last.year:
             info_labels["year"] = last.year
 
-        _, art, _ = _tmdb_labels_and_art(last.title)
+        _, art, _ = tmdb_prefetched.get(last.title, ({}, {}, []))
+        _add_directory_item(handle, display_label, "search", {"query": last.title}, is_folder=True, info_labels=info_labels, art=art)
 
-        params: dict[str, str] = {
-            "plugin": plugin_name,
-            "title": matched_title,
-            "season": f"Staffel {next_season}",
-        }
-        _add_directory_item(handle, display_label, "episodes", params, is_folder=True, info_labels=info_labels, art=art)
-
-    xbmcplugin.endOfDirectory(handle)
+    xbmcplugin.endOfDirectory(handle, cacheToDisc=False)
 
 
 # ---------------------------------------------------------------------------
@@ -5255,7 +5415,7 @@ def _route_plugin_menu(params: dict[str, str]) -> None:
 
 @_router.route("plugin_search")
 def _route_plugin_search(params: dict[str, str]) -> None:
-    _show_plugin_search(params.get("plugin", ""))
+    _show_plugin_search(params.get("plugin", ""), params.get("query", ""))
 
 
 @_router.route("genres")
@@ -5353,6 +5513,11 @@ def _route_install_ytdlp(params: dict[str, str]) -> None:
     _ensure_ytdlp_installed(force=True, silent=False)
 
 
+@_router.route("install_tmdb_helper_players")
+def _route_install_tmdb_helper_players(params: dict[str, str]) -> None:
+    _install_tmdb_helper_players()
+
+
 @_router.route("choose_source")
 def _route_choose_source(params: dict[str, str]) -> None:
     _show_choose_source(params.get("title", ""), params.get("plugins", ""))
@@ -5403,6 +5568,63 @@ def _route_play_movie(params: dict[str, str]) -> None:
         _play_episode(plugin_name, title, "Film", "Stream", resolve_handle=_get_handle())
 
 
+@_router.route("play_direct")
+def _route_play_direct(params: dict[str, str]) -> None:
+    """Direkte Wiedergabe ohne Ordner-Navigation: sucht Titel im Plugin, nimmt besten Match."""
+    plugin_name = (params.get("plugin", "") or "").strip()
+    query = (params.get("query", "") or "").strip()
+    season_num = _parse_positive_int(params.get("season", "1"), default=1)
+    episode_num = _parse_positive_int(params.get("episode", "1"), default=1)
+    is_movie = params.get("type", "").lower() == "movie"
+
+    plugin = _discover_plugins().get(plugin_name)
+    if not plugin:
+        xbmcgui.Dialog().notification("ViewIT", f"Plugin nicht gefunden: {plugin_name}", xbmcgui.NOTIFICATION_ERROR, 4000)
+        return
+    if not query:
+        xbmcgui.Dialog().notification("ViewIT", "Kein Suchtitel angegeben.", xbmcgui.NOTIFICATION_ERROR, 4000)
+        return
+
+    # Suche im Plugin
+    try:
+        search_coro = _call_plugin_search(plugin, query)
+        results = _run_async(search_coro)
+        results = _clean_search_titles([str(t).strip() for t in (results or []) if t and str(t).strip()])
+    except Exception as exc:
+        xbmcgui.Dialog().notification("ViewIT", f"Suche fehlgeschlagen: {exc}", xbmcgui.NOTIFICATION_ERROR, 4000)
+        return
+
+    if not results:
+        xbmcgui.Dialog().notification("ViewIT", f"Kein Ergebnis für: {query}", xbmcgui.NOTIFICATION_WARNING, 4000)
+        return
+
+    # Besten Match wählen: bevorzuge Titel die den Query enthalten
+    from search_utils import matches_query as _mq
+    matched = [r for r in results if _mq(query, title=r)]
+    title = matched[0] if matched else results[0]
+
+    if is_movie:
+        _play_episode(plugin_name, title, "Film", "Stream", resolve_handle=_get_handle())
+    else:
+        season_label = f"Staffel {season_num}"
+        # Episodenlabel exakt aus dem Plugin holen (z.B. "Episode 3: Titel (Original)")
+        episode_label = f"Episode {episode_num}"
+        episodes = getattr(plugin, "episodes_for", None)
+        if callable(episodes):
+            try:
+                ep_list = episodes(title, season_label)
+                # Suche das Label das mit "Episode {episode_num}:" oder "Episode {episode_num} " beginnt
+                prefix = f"Episode {episode_num}:"
+                prefix2 = f"Episode {episode_num} "
+                for ep in (ep_list or []):
+                    if ep.startswith(prefix) or ep.startswith(prefix2) or ep == f"Episode {episode_num}":
+                        episode_label = ep
+                        break
+            except Exception:
+                pass
+        _play_episode(plugin_name, title, season_label, episode_label, resolve_handle=_get_handle())
+
+
 @_router.route("play_episode_url")
 def _route_play_episode_url(params: dict[str, str]) -> None:
     _play_episode_url(
@@ -5479,6 +5701,11 @@ def _route_random_title(params: dict[str, str]) -> None:
     _play_random_title(params.get("plugin", ""))
 
 
+@_router.route("trakt_menu")
+def _route_trakt_menu(params: dict[str, str]) -> None:
+    _show_trakt_menu()
+
+
 @_router.route("trakt_auth")
 def _route_trakt_auth(params: dict[str, str]) -> None:
     _trakt_authorize()
@@ -5552,12 +5779,47 @@ def _route_fallback(params: dict[str, str]) -> None:
     _show_root_menu()
 
 
+def _maybe_show_changelog() -> None:
+    """Zeigt beim ersten Start nach einem Update das Benutzer-Changelog an."""
+    try:
+        current_version = str(_get_addon().getAddonInfo("version") or "").strip()
+        last_shown = _get_setting_string("changelog_last_shown_version").strip()
+        if not current_version or current_version == last_shown:
+            return
+        changelog_path = Path(__file__).parent / "CHANGELOG-USER.md"
+        if not changelog_path.exists():
+            return
+        text = changelog_path.read_text(encoding="utf-8")
+        # Ersten Abschnitt (neueste Version) extrahieren
+        lines = text.splitlines()
+        section: list[str] = []
+        for line in lines:
+            if line.startswith("## ") and section:
+                break
+            section.append(line)
+        content = "\n".join(section).strip()
+        if not content:
+            return
+        viewer = getattr(xbmcgui.Dialog(), "textviewer", None)
+        if callable(viewer):
+            try:
+                viewer("Was ist neu?", content)
+            except Exception:
+                pass
+        _get_addon().setSetting("changelog_last_shown_version", current_version)
+    except Exception as exc:
+        _log(f"Changelog-Anzeige fehlgeschlagen: {exc}", xbmc.LOGWARNING)
+
+
 def run() -> None:
     params = _parse_params()
     action = params.get("action")
     _log(f"Action: {action}", xbmc.LOGDEBUG)
     _maybe_run_auto_update_check(action)
     _maybe_auto_install_resolveurl(action)
+    _sync_trakt_status_setting()
+    if not action:
+        _maybe_show_changelog()
     _router.dispatch(action=action, params=params)
 
 

addon/plugins/filmpalast_plugin.py

@@ -893,8 +893,8 @@ class FilmpalastPlugin(BasisPlugin):
         for block in soup.select("ul.currentStreamLinks"):
             host_name_node = block.select_one("li.hostBg .hostName")
             host_name = self._normalize_hoster_name(host_name_node.get_text(" ", strip=True) if host_name_node else "")
-            play_anchor = block.select_one("li.streamPlayBtn a[href], a.button.iconPlay[href]")
-            href = (play_anchor.get("href") if play_anchor else "") or ""
+            play_anchor = block.select_one("li.streamPlayBtn a[href], li.streamPlayBtn a[data-player-url], a.button.iconPlay[href]")
+            href = (play_anchor.get("href") or play_anchor.get("data-player-url") if play_anchor else "") or ""
             play_url = _absolute_url(href).strip()
             if not play_url:
                 continue

addon/plugins/hdfilme_plugin.py

@@ -388,7 +388,7 @@ class HdfilmePlugin(BasisPlugin):
         info: dict[str, str] = {"title": title}
         art: dict[str, str] = {}
 
-        # Cache-Hit
+        # Cache-Hit – nur zurückgeben wenn Plot vorhanden (sonst Detailseite laden)
         cached = self._title_meta.get(title)
         if cached:
             plot, poster = cached
@@ -396,7 +396,7 @@ class HdfilmePlugin(BasisPlugin):
                 info["plot"] = plot
             if poster:
                 art["thumb"] = art["poster"] = poster
-            if info or art:
+            if plot:
                 return info, art, None
 
         # Detailseite laden

addon/plugins/serienstream_plugin.py

@@ -57,7 +57,6 @@ else:  # pragma: no cover
 
 
 SETTING_BASE_URL = "serienstream_base_url"
-SETTING_CATALOG_SEARCH = "serienstream_catalog_search"
 DEFAULT_BASE_URL = "https://s.to"
 DEFAULT_PREFERRED_HOSTERS = ["voe"]
 DEFAULT_TIMEOUT = 20
@@ -80,10 +79,7 @@ HEADERS = {
 SESSION_CACHE_TTL_SECONDS = 300
 SESSION_CACHE_PREFIX = "viewit.serienstream"
 SESSION_CACHE_MAX_TITLE_URLS = 800
-CATALOG_SEARCH_TTL_SECONDS = 600
-CATALOG_SEARCH_CACHE_KEY = "catalog_index"
 GENRE_LIST_PAGE_SIZE = 20
-_CATALOG_INDEX_MEMORY: tuple[float, list["SeriesResult"]] = (0.0, [])
 ProgressCallback = Optional[Callable[[str, int | None], Any]]
 
 
@@ -509,6 +505,14 @@ def _strip_tags(value: str) -> str:
     return re.sub(r"<[^>]+>", " ", value or "")
 
 
+def _clean_collection_title(title: str) -> str:
+    cleaned = "".join(
+        ch for ch in title
+        if unicodedata.category(ch) not in ("So", "Sm", "Sk", "Sc", "Cs", "Co", "Cn")
+    )
+    return re.sub(r"\s+", " ", cleaned).strip()
+
+
 def _search_series_api(query: str) -> list[SeriesResult]:
     query = (query or "").strip()
     if not query:
@@ -575,8 +579,8 @@ def _search_series_server(query: str) -> list[SeriesResult]:
     if not query:
         return []
     base = _get_base_url()
-    search_url = f"{base}/search?q={quote(query)}"
-    alt_url = f"{base}/suche?q={quote(query)}"
+    search_url = f"{base}/suche?term={quote(query)}"
+    alt_url = f"{base}/search?term={quote(query)}"
     for url in (search_url, alt_url):
         try:
             body = _get_html_simple(url)
@@ -606,158 +610,30 @@ def _search_series_server(query: str) -> list[SeriesResult]:
                 continue
             seen_urls.add(url_abs)
             results.append(SeriesResult(title=title, description="", url=url_abs))
+        filtered = [r for r in results if _matches_query(query, title=r.title)]
+        if filtered:
+            return filtered
         if results:
             return results
-    api_results = _search_series_api(query)
-    if api_results:
-        return api_results
     return []
 
 
-def _extract_catalog_index_from_html(body: str, *, progress_callback: ProgressCallback = None) -> list[SeriesResult]:
-    items: list[SeriesResult] = []
-    if not body:
-        return items
-    seen_urls: set[str] = set()
-    item_re = re.compile(
-        r"<li[^>]*class=[\"'][^\"']*series-item[^\"']*[\"'][^>]*>(.*?)</li>",
-        re.IGNORECASE | re.DOTALL,
-    )
-    anchor_re = re.compile(r"<a[^>]+href=[\"']([^\"']+)[\"'][^>]*>(.*?)</a>", re.IGNORECASE | re.DOTALL)
-    data_search_re = re.compile(r"data-search=[\"']([^\"']*)[\"']", re.IGNORECASE)
-    for idx, match in enumerate(item_re.finditer(body), start=1):
-        if idx == 1 or idx % 200 == 0:
-            _emit_progress(progress_callback, f"Katalog parsen {idx}", 62)
-        block = match.group(0)
-        inner = match.group(1) or ""
-        anchor_match = anchor_re.search(inner)
-        if not anchor_match:
-            continue
-        href = (anchor_match.group(1) or "").strip()
-        url = _absolute_url(href)
-        if not url or "/serie/" not in url or "/staffel-" in url or "/episode-" in url:
-            continue
-        if url in seen_urls:
-            continue
-        seen_urls.add(url)
-        title_raw = anchor_match.group(2) or ""
-        title = unescape(re.sub(r"\s+", " ", _strip_tags(title_raw))).strip()
-        if not title:
-            continue
-        search_match = data_search_re.search(block)
-        description = (search_match.group(1) or "").strip() if search_match else ""
-        items.append(SeriesResult(title=title, description=description, url=url))
-    return items
-
-
-def _catalog_index_from_soup(soup: BeautifulSoupT) -> list[SeriesResult]:
-    items: list[SeriesResult] = []
-    if not soup:
-        return items
-    seen_urls: set[str] = set()
-    for item in soup.select("li.series-item"):
-        anchor = item.find("a", href=True)
-        if not anchor:
-            continue
-        href = (anchor.get("href") or "").strip()
-        url = _absolute_url(href)
-        if not url or "/serie/" not in url or "/staffel-" in url or "/episode-" in url:
-            continue
-        if url in seen_urls:
-            continue
-        seen_urls.add(url)
-        title = (anchor.get_text(" ", strip=True) or "").strip()
-        if not title:
-            continue
-        description = (item.get("data-search") or "").strip()
-        items.append(SeriesResult(title=title, description=description, url=url))
-    return items
-
-
-def _load_catalog_index_from_cache() -> Optional[list[SeriesResult]]:
-    global _CATALOG_INDEX_MEMORY
-    expires_at, cached = _CATALOG_INDEX_MEMORY
-    if cached and expires_at > time.time():
-        return list(cached)
-    raw = _session_cache_get(CATALOG_SEARCH_CACHE_KEY)
-    if not isinstance(raw, list):
-        return None
-    items: list[SeriesResult] = []
-    for entry in raw:
-        if not isinstance(entry, list) or len(entry) < 2:
-            continue
-        title = str(entry[0] or "").strip()
-        url = str(entry[1] or "").strip()
-        description = str(entry[2] or "") if len(entry) > 2 else ""
-        cover = str(entry[3] or "").strip() if len(entry) > 3 else ""
-        if title and url:
-            items.append(SeriesResult(title=title, description=description, url=url, cover=cover))
-    if items:
-        _CATALOG_INDEX_MEMORY = (time.time() + CATALOG_SEARCH_TTL_SECONDS, list(items))
-    return items or None
-
-
-def _store_catalog_index_in_cache(items: list[SeriesResult]) -> None:
-    global _CATALOG_INDEX_MEMORY
-    if not items:
-        return
-    _CATALOG_INDEX_MEMORY = (time.time() + CATALOG_SEARCH_TTL_SECONDS, list(items))
-    payload: list[list[str]] = []
-    for entry in items:
-        if not entry.title or not entry.url:
-            continue
-        payload.append([entry.title, entry.url, entry.description, entry.cover])
-    _session_cache_set(CATALOG_SEARCH_CACHE_KEY, payload, ttl_seconds=CATALOG_SEARCH_TTL_SECONDS)
-
 
 def search_series(query: str, *, progress_callback: ProgressCallback = None) -> list[SeriesResult]:
-    """Sucht Serien. Katalog-Suche (vollstaendig) oder API-Suche (max 10) je nach Setting."""
+    """Sucht Serien. Server-Suche (/suche?term=) zuerst, API als Fallback."""
     _ensure_requests()
     if not _normalize_search_text(query):
         return []
 
-    use_catalog = _get_setting_bool(SETTING_CATALOG_SEARCH, default=True)
-
-    if use_catalog:
-        _emit_progress(progress_callback, "Pruefe Such-Cache", 15)
-        cached = _load_catalog_index_from_cache()
-        if cached is not None:
-            matched_from_cache = [entry for entry in cached if entry.title and _matches_query(query, title=entry.title)]
-            _emit_progress(progress_callback, f"Cache-Treffer: {len(cached)}", 35)
-            if matched_from_cache:
-                return matched_from_cache
-
-        _emit_progress(progress_callback, "Lade Katalogseite", 42)
-        catalog_url = f"{_get_base_url()}/serien?by=genre"
-        items: list[SeriesResult] = []
-        try:
-            soup = _get_soup_simple(catalog_url)
-            items = _catalog_index_from_soup(soup)
-        except Exception:
-            body = _get_html_simple(catalog_url)
-            items = _extract_catalog_index_from_html(body, progress_callback=progress_callback)
-            if not items:
-                _emit_progress(progress_callback, "Fallback-Parser", 58)
-                soup = BeautifulSoup(body, "html.parser")
-                items = _catalog_index_from_soup(soup)
-        if items:
-            _store_catalog_index_in_cache(items)
-            _emit_progress(progress_callback, f"Filtere Treffer ({len(items)})", 70)
-            return [entry for entry in items if entry.title and _matches_query(query, title=entry.title)]
-
-    # API-Suche (primaer wenn Katalog deaktiviert, Fallback wenn Katalog leer)
-    _emit_progress(progress_callback, "API-Suche", 60)
-    api_results = _search_series_api(query)
-    if api_results:
-        _emit_progress(progress_callback, f"API-Treffer: {len(api_results)}", 80)
-        return api_results
-
-    _emit_progress(progress_callback, "Server-Suche", 85)
+    # 1. Server-Suche (schnell, vollstaendig, direkte HTML-Suche)
+    _emit_progress(progress_callback, "Suche", 20)
     server_results = _search_series_server(query)
     if server_results:
-        _emit_progress(progress_callback, f"Server-Treffer: {len(server_results)}", 95)
-        return [entry for entry in server_results if entry.title and _matches_query(query, title=entry.title)]
-    return []
+        return server_results
+
+    # 2. API-Suche (Fallback, max 10 Ergebnisse)
+    _emit_progress(progress_callback, "API-Suche", 60)
+    return _search_series_api(query)
 
 
 def parse_series_catalog(soup: BeautifulSoupT) -> dict[str, list[SeriesResult]]:
@@ -1159,6 +1035,8 @@ class SerienstreamPlugin(BasisPlugin):
         self._latest_hoster_cache: dict[str, list[str]] = {}
         self._series_metadata_cache: dict[str, tuple[dict[str, str], dict[str, str]]] = {}
         self._series_metadata_full: set[str] = set()
+        self._collection_url_cache: dict[str, str] = {}
+        self._collection_has_more: bool = False
         self.is_available = True
         self.unavailable_reason: str | None = None
         if not self._requests_available:  # pragma: no cover - optional dependency
@@ -1252,7 +1130,7 @@ class SerienstreamPlugin(BasisPlugin):
             except Exception:
                 continue
             url = str(item.get("url") or "").strip()
-            if number <= 0 or not url:
+            if number < 0 or not url:
                 continue
             seasons.append(SeasonInfo(number=number, url=url, episodes=[]))
         if not seasons:
@@ -1383,7 +1261,63 @@ class SerienstreamPlugin(BasisPlugin):
 
     def capabilities(self) -> set[str]:
         """Meldet unterstützte Features für Router-Menüs."""
-        return {"popular_series", "genres", "latest_episodes", "alpha"}
+        return {"popular_series", "genres", "latest_episodes", "alpha", "collections"}
+
+    def collections(self) -> list[str]:
+        """Liefert Sammlungs-Namen von /sammlungen (Seite 1, für Paginierung)."""
+        return self._collections_page(1)
+
+    def _collections_page(self, page: int = 1) -> list[str]:
+        """Liefert eine Seite mit Sammlungs-Namen von /sammlungen (paginiert)."""
+        if not self._requests_available:
+            return []
+        base = _get_base_url()
+        names: list[str] = []
+        url_map: dict[str, str] = {}
+        url = f"{base}/sammlungen" if page == 1 else f"{base}/sammlungen?page={page}"
+        soup = _get_soup_simple(url)
+        for a in soup.select('a[href*="/sammlung/"]'):
+            h2 = a.find("h2")
+            if not h2:
+                continue
+            title = _clean_collection_title(h2.get_text(strip=True))
+            href = (a.get("href") or "").strip()
+            if title and href:
+                url_map[title] = _absolute_url(href)
+                names.append(title)
+        if url_map:
+            existing = _session_cache_get("collection_urls")
+            if isinstance(existing, dict):
+                existing.update(url_map)
+                _session_cache_set("collection_urls", existing)
+            else:
+                _session_cache_set("collection_urls", url_map)
+        names.sort(key=lambda t: t.casefold())
+        return names
+
+    def titles_for_collection(self, collection: str, page: int = 1) -> list[str]:
+        """Liefert Serien-Titel einer Sammlung (paginiert)."""
+        if not self._requests_available:
+            return []
+        url_map = _session_cache_get("collection_urls")
+        if isinstance(url_map, dict):
+            self._collection_url_cache.update(url_map)
+        url = self._collection_url_cache.get(collection)
+        if not url:
+            return []
+        if page > 1:
+            url = f"{url}?page={page}"
+        base_url = self._collection_url_cache[collection]
+        soup = _get_soup_simple(url)
+        titles: list[str] = []
+        for a in soup.select('h6 a[href*="/serie/"]'):
+            title = a.get_text(strip=True)
+            href = (a.get("href") or "").strip()
+            if title and href:
+                self._remember_series_result(title, _absolute_url(href), "")
+                titles.append(title)
+        self._collection_has_more = bool(soup.select(f'a[href*="?page={page + 1}"]'))
+        return titles
 
     def popular_series(self) -> list[str]:
         """Liefert die Titel der beliebten Serien (Quelle: `/beliebte-serien`)."""
@@ -1794,6 +1728,8 @@ class SerienstreamPlugin(BasisPlugin):
 
     @staticmethod
     def _season_label(number: int) -> str:
+        if number == 0:
+            return "Filme"
         return f"Staffel {number}"
 
     @staticmethod
@@ -1808,6 +1744,8 @@ class SerienstreamPlugin(BasisPlugin):
 
     @staticmethod
     def _parse_season_number(label: str) -> int | None:
+        if (label or "").strip().casefold() == "filme":
+            return 0
         digits = "".join(ch for ch in label if ch.isdigit())
         if not digits:
             return None

addon/plugins/topstreamfilm_plugin.py

@@ -1167,7 +1167,7 @@ class TopstreamfilmPlugin(BasisPlugin):
         return resolve_via_resolveurl(link, fallback_to_link=True)
 
     def capabilities(self) -> set[str]:
-        return {"genres", "popular_series", "year_filter", "new_titles"}
+        return {"genres", "popular_series", "year_filter"}
 
     def years_available(self) -> List[str]:
         """Liefert verfügbare Erscheinungsjahre (aktuelles Jahr bis 1980)."""

addon/resources/players/viewit_global.json

@@ -0,0 +1,11 @@
+{
+    "name"              : "ViewIT (Globale Suche)",
+    "plugin"            : "plugin.video.viewit",
+    "priority"          : 900,
+    "assert"            : {
+                            "search_movie":     ["title"],
+                            "search_episode":   ["showname"]
+                          },
+    "search_movie"      : "plugin://plugin.video.viewit/?action=search&query={title_url}",
+    "search_episode"    : "plugin://plugin.video.viewit/?action=search&query={showname_url}"
+}

addon/resources/players/viewit_serienstream.json

@@ -0,0 +1,21 @@
+{
+    "name"              : "ViewIT (SerienStream)",
+    "plugin"            : "plugin.video.viewit",
+    "priority"          : 1000,
+    "provider"          : "SerienStream",
+    "is_resolvable"     : "true",
+    "assert"            : {
+                            "play_movie":       ["title"],
+                            "play_episode":     ["showname", "season", "episode"],
+                            "search_movie":     ["title"],
+                            "search_episode":   ["showname"]
+                          },
+    "play_movie"        : "plugin://plugin.video.viewit/?action=play_direct&plugin=Serienstream&type=movie&query={title_url}",
+    "play_episode"      : "plugin://plugin.video.viewit/?action=play_direct&plugin=Serienstream&type=episode&query={showname_url}&season={season}&episode={episode}",
+    "search_movie"      : [
+                            "plugin://plugin.video.viewit/?action=plugin_search&plugin=Serienstream&query={title_url}"
+                          ],
+    "search_episode"    : [
+                            "plugin://plugin.video.viewit/?action=plugin_search&plugin=Serienstream&query={showname_url}"
+                          ]
+}

addon/resources/settings.xml

@@ -1,42 +1,82 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <settings>
-  <category label="Quellen">
-    <setting id="serienstream_base_url" type="text" label="SerienStream Basis-URL" default="https://s.to" />
-    <setting id="serienstream_catalog_search" type="bool" label="SerienStream: Katalog-Suche (mehr Ergebnisse, langsamer)" default="true" />
-    <setting id="aniworld_base_url" type="text" label="AniWorld Basis-URL" default="https://aniworld.to" />
-    <setting id="topstream_base_url" type="text" label="TopStream Basis-URL" default="https://topstreamfilm.live" />
-    <setting id="einschalten_base_url" type="text" label="Einschalten Basis-URL" default="https://einschalten.in" />
-    <setting id="filmpalast_base_url" type="text" label="Filmpalast Basis-URL" default="https://filmpalast.to" />
-    <setting id="doku_streams_base_url" type="text" label="Doku-Streams Basis-URL" default="https://doku-streams.com" />
+
+  <category label="Wiedergabe">
+    <setting id="autoplay_enabled" type="bool" label="Autoplay (bevorzugten Hoster automatisch waehlen)" default="false" />
+    <setting id="preferred_hoster" type="enum" label="Bevorzugter Hoster" default="0" values="voe|streamtape|doodstream|vidoza|mixdrop|supervideo|dropload" enable="eq(-1,true)" />
+  </category>
+
+  <category label="Globale Suche">
+    <setting id="search_plugin_serienstream" type="bool" label="Serienstream durchsuchen" default="true" />
+    <setting id="search_plugin_aniworld" type="bool" label="Aniworld durchsuchen" default="true" />
+    <setting id="search_plugin_topstreamfilm" type="bool" label="Topstreamfilm durchsuchen" default="true" />
+    <setting id="search_plugin_filmpalast" type="bool" label="Filmpalast durchsuchen" default="true" />
+    <setting id="search_plugin_moflix" type="bool" label="Moflix durchsuchen" default="true" />
+    <setting id="search_plugin_kkiste" type="bool" label="KKiste durchsuchen" default="true" />
+    <setting id="search_plugin_hdfilme" type="bool" label="HDFilme durchsuchen" default="true" />
+    <setting id="search_plugin_einschalten" type="bool" label="Einschalten durchsuchen" default="true" />
+    <setting id="search_plugin_doku_streams" type="bool" label="Doku-Streams durchsuchen" default="true" />
+    <setting id="search_plugin_netzkino" type="bool" label="NetzkKino durchsuchen" default="true" />
+    <setting id="search_plugin_youtube" type="bool" label="YouTube durchsuchen" default="false" />
+  </category>
+
+  <category label="Trakt">
+    <setting id="trakt_enabled" type="bool" label="Trakt aktivieren" default="false" />
+    <setting id="trakt_status" type="text" label="Status" default="Nicht verbunden" enable="false" />
+    <setting id="trakt_auth" type="action" label="Trakt autorisieren" action="RunPlugin(plugin://plugin.video.viewit/?action=trakt_auth)" option="close" />
+    <setting id="trakt_scrobble" type="bool" label="Scrobbling aktivieren" default="true" enable="eq(-3,true)" />
+    <setting id="trakt_auto_watchlist" type="bool" label="Geschaute Serien automatisch zur Watchlist hinzufuegen" default="false" enable="eq(-4,true)" />
+    <setting id="trakt_access_token" type="text" label="" default="" visible="false" />
+    <setting id="trakt_refresh_token" type="text" label="" default="" visible="false" />
+    <setting id="trakt_token_expires" type="text" label="" default="0" visible="false" />
   </category>
 
   <category label="Metadaten">
-    <setting id="serienstream_metadata_source" type="enum" label="SerienStream Metadatenquelle" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
-    <setting id="aniworld_metadata_source" type="enum" label="AniWorld Metadatenquelle" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
-    <setting id="topstreamfilm_metadata_source" type="enum" label="TopStream Metadatenquelle" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
-    <setting id="einschalten_metadata_source" type="enum" label="Einschalten Metadatenquelle" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
-    <setting id="filmpalast_metadata_source" type="enum" label="Filmpalast Metadatenquelle" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
-    <setting id="doku_streams_metadata_source" type="enum" label="Doku-Streams Metadatenquelle" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
-    <setting id="kkiste_metadata_source" type="enum" label="KKiste Metadatenquelle" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
-    <setting id="moflix_metadata_source" type="enum" label="Moflix Metadatenquelle" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
     <setting id="tmdb_enabled" type="bool" label="TMDB aktivieren" default="true" />
-    <setting id="tmdb_language" type="text" label="TMDB Sprache (z. B. de-DE)" default="de-DE" />
-    <setting id="tmdb_show_plot" type="bool" label="TMDB Beschreibung anzeigen" default="true" />
-    <setting id="tmdb_show_art" type="bool" label="TMDB Poster und Vorschaubild anzeigen" default="true" />
-    <setting id="tmdb_show_fanart" type="bool" label="TMDB Fanart/Backdrop anzeigen" default="true" />
-    <setting id="tmdb_show_rating" type="bool" label="TMDB Bewertung anzeigen" default="true" />
-    <setting id="tmdb_show_votes" type="bool" label="TMDB Stimmen anzeigen" default="false" />
+    <setting id="tmdb_language" type="text" label="TMDB Sprache (z. B. de-DE)" default="de-DE" enable="eq(-1,true)" />
+    <setting id="tmdb_show_plot" type="bool" label="Beschreibung anzeigen" default="true" enable="eq(-2,true)" />
+    <setting id="tmdb_show_art" type="bool" label="Poster und Vorschaubild anzeigen" default="true" enable="eq(-3,true)" />
+    <setting id="tmdb_show_fanart" type="bool" label="Fanart/Backdrop anzeigen" default="true" enable="eq(-4,true)" />
+    <setting id="tmdb_show_rating" type="bool" label="Bewertung anzeigen" default="true" enable="eq(-5,true)" />
+    <setting id="tmdb_show_votes" type="bool" label="Stimmen anzeigen" default="false" enable="eq(-6,true)" />
+    <setting type="lsep" label="Metadatenquellen" />
+    <setting id="serienstream_metadata_source" type="enum" label="SerienStream" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
+    <setting id="aniworld_metadata_source" type="enum" label="AniWorld" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
+    <setting id="topstreamfilm_metadata_source" type="enum" label="TopStream" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
+    <setting id="einschalten_metadata_source" type="enum" label="Einschalten" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
+    <setting id="filmpalast_metadata_source" type="enum" label="Filmpalast" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
+    <setting id="doku_streams_metadata_source" type="enum" label="Doku-Streams" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
+    <setting id="kkiste_metadata_source" type="enum" label="KKiste" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
+    <setting id="moflix_metadata_source" type="enum" label="Moflix" default="0" values="Automatisch|Quelle|TMDB|Mischen" />
   </category>
 
-  <category label="TMDB Erweitert">
-    <setting id="tmdb_api_key" type="text" label="TMDB API Key (optional)" default="" />
-    <setting id="tmdb_api_key_active" type="text" label="Aktiver TMDB API Key" default="" />
-    <setting id="tmdb_prefetch_concurrency" type="number" label="TMDB: gleichzeitige Anfragen (1-20)" default="6" />
-    <setting id="tmdb_show_cast" type="bool" label="TMDB Besetzung anzeigen" default="false" />
-    <setting id="tmdb_show_episode_cast" type="bool" label="TMDB Besetzung pro Episode anzeigen" default="false" />
-    <setting id="tmdb_genre_metadata" type="bool" label="TMDB Daten in Genre-Listen anzeigen" default="false" />
-    <setting id="tmdb_log_requests" type="bool" label="TMDB API-Anfragen loggen" default="false" />
-    <setting id="tmdb_log_responses" type="bool" label="TMDB API-Antworten loggen" default="false" />
+  <category label="Updates">
+    <setting id="update_installed_version" type="text" label="Installierte Version" default="-" enable="false" />
+    <setting id="update_available_selected" type="text" label="Verfuegbar (gewaehlter Kanal)" default="-" enable="false" />
+    <setting id="update_channel" type="enum" label="Update-Kanal" default="1" values="Main|Nightly|Custom|Dev" />
+    <setting id="apply_update_channel" type="action" label="Update-Kanal jetzt anwenden" action="RunPlugin(plugin://plugin.video.viewit/?action=apply_update_channel)" option="close" />
+    <setting id="auto_update_enabled" type="bool" label="Automatische Updates (beim Start pruefen)" default="false" />
+    <setting id="auto_update_interval" type="enum" label="Update-Pruefintervall" default="1" values="1 Stunde|6 Stunden|24 Stunden" enable="eq(-1,true)" />
+    <setting id="select_update_version" type="action" label="Version waehlen und installieren" action="RunPlugin(plugin://plugin.video.viewit/?action=select_update_version)" option="close" />
+    <setting type="lsep" label="ResolveURL" />
+    <setting id="install_resolveurl" type="action" label="ResolveURL installieren/reparieren" action="RunPlugin(plugin://plugin.video.viewit/?action=install_resolveurl)" option="close" />
+    <setting id="resolveurl_auto_install" type="bool" label="ResolveURL automatisch installieren (beim Start pruefen)" default="true" />
+    <setting id="resolveurl_status" type="text" label="ResolveURL Status" default="-" enable="false" />
+    <setting type="lsep" label="Kanaldetails" />
+    <setting id="update_active_channel" type="text" label="Aktiver Kanal" default="-" enable="false" />
+    <setting id="update_active_repo_url" type="text" label="Aktive Repo URL" default="-" enable="false" />
+    <setting id="update_repo_url_main" type="text" label="Main URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/main/addons.xml" />
+    <setting id="update_repo_url_nightly" type="text" label="Nightly URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/nightly/addons.xml" />
+    <setting id="update_repo_url_dev" type="text" label="Dev URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/dev/addons.xml" />
+    <setting id="update_repo_url" type="text" label="Custom URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/nightly/addons.xml" />
+    <setting id="auto_update_last_ts" type="text" label="" default="0" visible="false" />
+    <setting id="resolveurl_last_ts" type="text" label="" default="0" visible="false" />
+  </category>
+
+  <category label="YouTube">
+    <setting id="youtube_quality" type="enum" label="YouTube Videoqualitaet" default="0" values="Beste|1080p|720p|480p|360p" />
+    <setting id="install_ytdlp" type="action" label="yt-dlp installieren/reparieren" action="RunPlugin(plugin://plugin.video.viewit/?action=install_ytdlp)" option="close" />
+    <setting id="ytdlp_status" type="text" label="yt-dlp Status" default="-" enable="false" />
   </category>
 
   <category label="Anzeige">
@@ -50,43 +90,27 @@
     <setting id="einschalten_max_page_items" type="number" label="Einschalten: Max. Eintraege pro Seite" default="15" />
   </category>
 
-  <category label="Wiedergabe">
-    <setting id="autoplay_enabled" type="bool" label="Autoplay (bevorzugten Hoster automatisch waehlen)" default="false" />
-    <setting id="preferred_hoster" type="text" label="Bevorzugter Hoster" default="voe" />
+  <category label="TMDB Erweitert">
+    <setting id="tmdb_api_key" type="text" label="TMDB API Key (optional)" default="" />
+    <setting id="tmdb_api_key_active" type="text" label="Aktiver TMDB API Key" default="" enable="false" />
+    <setting id="tmdb_prefetch_concurrency" type="number" label="TMDB: gleichzeitige Anfragen (1-20)" default="6" />
+    <setting id="tmdb_show_cast" type="bool" label="TMDB Besetzung anzeigen" default="false" />
+    <setting id="tmdb_show_episode_cast" type="bool" label="TMDB Besetzung pro Episode anzeigen" default="false" />
+    <setting id="tmdb_genre_metadata" type="bool" label="TMDB Daten in Genre-Listen anzeigen" default="false" />
+    <setting id="tmdb_log_requests" type="bool" label="TMDB API-Anfragen loggen" default="false" />
+    <setting id="tmdb_log_responses" type="bool" label="TMDB API-Antworten loggen" default="false" />
   </category>
 
-  <category label="Updates">
-    <setting id="update_channel" type="enum" label="Update-Kanal" default="1" values="Main|Nightly|Custom|Dev" />
-    <setting id="apply_update_channel" type="action" label="Update-Kanal jetzt anwenden" action="RunPlugin(plugin://plugin.video.viewit/?action=apply_update_channel)" option="close" />
-    <setting id="auto_update_enabled" type="bool" label="Automatische Updates (beim Start pruefen)" default="false" />
-    <setting id="auto_update_interval" type="enum" label="Update-Pruefintervall" default="1" values="1 Stunde|6 Stunden|24 Stunden" />
-    <setting id="select_update_version" type="action" label="Version waehlen und installieren" action="RunPlugin(plugin://plugin.video.viewit/?action=select_update_version)" option="close" />
-    <setting id="install_resolveurl" type="action" label="ResolveURL installieren/reparieren" action="RunPlugin(plugin://plugin.video.viewit/?action=install_resolveurl)" option="close" />
-    <setting id="resolveurl_auto_install" type="bool" label="ResolveURL automatisch installieren (beim Start pruefen)" default="true" />
-    <setting id="update_installed_version" type="text" label="Installierte Version" default="-" enable="false" />
-    <setting id="update_available_selected" type="text" label="Verfuegbar (gewaehlter Kanal)" default="-" enable="false" />
-    <setting id="resolveurl_status" type="text" label="ResolveURL Status" default="-" enable="false" />
-    <setting id="update_active_channel" type="text" label="Aktiver Kanal" default="-" enable="false" />
-    <setting id="update_active_repo_url" type="text" label="Aktive Repo URL" default="-" enable="false" />
-    <setting id="update_repo_url_main" type="text" label="Main URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/main/addons.xml" />
-    <setting id="update_repo_url_nightly" type="text" label="Nightly URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/nightly/addons.xml" />
-    <setting id="update_repo_url_dev" type="text" label="Dev URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/dev/addons.xml" />
-    <setting id="update_repo_url" type="text" label="Custom URL (addons.xml)" default="https://gitea.it-drui.de/viewit/ViewIT-Kodi-Repo/raw/branch/nightly/addons.xml" />
-    <setting id="auto_update_last_ts" type="text" label="Auto-Update letzte Pruefung (intern)" default="0" visible="false" />
-    <setting id="resolveurl_last_ts" type="text" label="ResolveURL letzte Pruefung (intern)" default="0" visible="false" />
+  <category label="Quellen">
+    <setting id="serienstream_base_url" type="text" label="SerienStream Basis-URL" default="https://s.to" />
+    <setting id="aniworld_base_url" type="text" label="AniWorld Basis-URL" default="https://aniworld.to" />
+    <setting id="topstream_base_url" type="text" label="TopStream Basis-URL" default="https://topstreamfilm.live" />
+    <setting id="einschalten_base_url" type="text" label="Einschalten Basis-URL" default="https://einschalten.in" />
+    <setting id="filmpalast_base_url" type="text" label="Filmpalast Basis-URL" default="https://filmpalast.to" />
+    <setting id="doku_streams_base_url" type="text" label="Doku-Streams Basis-URL" default="https://doku-streams.com" />
   </category>
 
-  <category label="Trakt">
-    <setting id="trakt_enabled" type="bool" label="Trakt aktivieren" default="false" />
-    <setting id="trakt_auth" type="action" label="Trakt autorisieren" action="RunPlugin(plugin://plugin.video.viewit/?action=trakt_auth)" option="close" />
-    <setting id="trakt_scrobble" type="bool" label="Scrobbling aktivieren" default="true" />
-    <setting id="trakt_auto_watchlist" type="bool" label="Geschaute Serien automatisch zur Watchlist hinzufuegen" default="false" />
-    <setting id="trakt_access_token" type="text" label="" default="" visible="false" />
-    <setting id="trakt_refresh_token" type="text" label="" default="" visible="false" />
-    <setting id="trakt_token_expires" type="text" label="" default="0" visible="false" />
-  </category>
-
-  <category label="Debug Global">
+  <category label="Debug">
     <setting id="debug_log_urls" type="bool" label="URLs mitschreiben (global)" default="false" />
     <setting id="debug_dump_html" type="bool" label="HTML speichern (global)" default="false" />
     <setting id="debug_show_url_info" type="bool" label="Aktuelle URL anzeigen (global)" default="false" />
@@ -94,38 +118,36 @@
     <setting id="log_max_mb" type="number" label="URL-Log: maximale Dateigroesse (MB)" default="5" />
     <setting id="log_max_files" type="number" label="URL-Log: Anzahl alter Dateien" default="3" />
     <setting id="dump_max_files" type="number" label="HTML: maximale Dateien pro Plugin" default="200" />
-  </category>
-
-  <category label="Debug Quellen">
+    <setting type="lsep" label="Pro Quelle" />
     <setting id="log_urls_serienstream" type="bool" label="SerienStream: URLs mitschreiben" default="false" />
     <setting id="dump_html_serienstream" type="bool" label="SerienStream: HTML speichern" default="false" />
     <setting id="show_url_info_serienstream" type="bool" label="SerienStream: Aktuelle URL anzeigen" default="false" />
     <setting id="log_errors_serienstream" type="bool" label="SerienStream: Fehler mitschreiben" default="false" />
-
     <setting id="log_urls_aniworld" type="bool" label="AniWorld: URLs mitschreiben" default="false" />
     <setting id="dump_html_aniworld" type="bool" label="AniWorld: HTML speichern" default="false" />
     <setting id="show_url_info_aniworld" type="bool" label="AniWorld: Aktuelle URL anzeigen" default="false" />
     <setting id="log_errors_aniworld" type="bool" label="AniWorld: Fehler mitschreiben" default="false" />
-
     <setting id="log_urls_topstreamfilm" type="bool" label="TopStream: URLs mitschreiben" default="false" />
     <setting id="dump_html_topstreamfilm" type="bool" label="TopStream: HTML speichern" default="false" />
     <setting id="show_url_info_topstreamfilm" type="bool" label="TopStream: Aktuelle URL anzeigen" default="false" />
     <setting id="log_errors_topstreamfilm" type="bool" label="TopStream: Fehler mitschreiben" default="false" />
-
     <setting id="log_urls_einschalten" type="bool" label="Einschalten: URLs mitschreiben" default="false" />
     <setting id="dump_html_einschalten" type="bool" label="Einschalten: HTML speichern" default="false" />
     <setting id="show_url_info_einschalten" type="bool" label="Einschalten: Aktuelle URL anzeigen" default="false" />
     <setting id="log_errors_einschalten" type="bool" label="Einschalten: Fehler mitschreiben" default="false" />
-
     <setting id="log_urls_filmpalast" type="bool" label="Filmpalast: URLs mitschreiben" default="false" />
     <setting id="dump_html_filmpalast" type="bool" label="Filmpalast: HTML speichern" default="false" />
     <setting id="show_url_info_filmpalast" type="bool" label="Filmpalast: Aktuelle URL anzeigen" default="false" />
     <setting id="log_errors_filmpalast" type="bool" label="Filmpalast: Fehler mitschreiben" default="false" />
   </category>
-  <category label="YouTube">
-    <setting id="youtube_quality" type="enum" label="YouTube Videoqualitaet" default="0" values="Beste|1080p|720p|480p|360p" />
-    <setting id="install_ytdlp" type="action" label="yt-dlp installieren/reparieren" action="RunPlugin(plugin://plugin.video.viewit/?action=install_ytdlp)" option="close" />
-    <setting id="ytdlp_status" type="text" label="yt-dlp Status" default="-" enable="false" />
+
+  <category label="Tools">
+    <setting id="tmdb_helper_status" type="text" label="TMDb Helper Status" default="-" enable="false" />
+    <setting id="install_tmdb_helper_players" type="action" label="TMDb Helper Player installieren" action="RunPlugin(plugin://plugin.video.viewit/?action=install_tmdb_helper_players)" option="close" enable="eq(-1,Installiert)" />
+  </category>
+
+  <category label="Intern">
+    <setting id="changelog_last_shown_version" type="text" label="" default="" visible="false" />
   </category>
 
 </settings>

docs/ARCHITECTURE.md

@@ -58,6 +58,26 @@ Es ergänzt die Detaildokumente `DEFAULT_ROUTER.md` und `PLUGIN_SYSTEM.md`.
   - Zentrale Sammlung wiederverwendeter Regulärer Ausdrücke (Staffel/Episoden‑Tags, Ziffern etc.).
   - Ziel: Konsistenz und Vermeidung von fehleranfälligem Copy/Paste in Plugins.
 
+- **yt-dlp Helper (`addon/ytdlp_helper.py`)**
+  - Kapselt Zugriffe auf `yt-dlp` zum Auflösen von Stream-URLs.
+  - Wird als optionales Backend für Hoster genutzt, die weder ResolveURL noch direkte Links liefern.
+
+- **Genre-Helfer (`addon/genre_utils.py`)**
+  - Hilfsfunktionen für Genre-Normalisierung und -Mapping (plugin-übergreifend wiederverwendbar).
+
+- **Such-Helfer (`addon/search_utils.py`)**
+  - Gemeinsame Logik für titelbasierte Volltextsuche (Wortmatch, Normalisierung).
+  - Wird vom Router genutzt, um Plugin-Suchtreffer konsistent zu filtern.
+
+- **Kern-Module (`addon/core/`)**
+  - `trakt.py` – Trakt.tv-Integration (OAuth, Scrobbling, Watchlist, Upcoming, History).
+  - `metadata.py` – Metadaten-Aggregation aus Plugins und TMDB.
+  - `gui.py` – Dialog-Helfer und UI-Utilities (z.B. Changelog-Dialog).
+  - `playstate.py` – Playstate-Hilfsfunktionen (Schlüssel­berechnung, Zustandsabfrage). Eigenes Resume/Watched ist deaktiviert; Kodi verwaltet das selbst.
+  - `plugin_manager.py` – Plugin-Discovery und -Instanziierung.
+  - `router.py` – Routing-Helfer und Aktions-Dispatch.
+  - `updater.py` – Versionsprüfung und Addon-Update-Flow.
+
 - **Plugins (`addon/plugins/*.py`)**
   - Konkrete Integrationen zu einzelnen Providern (z.B. Serien-/Filmportale).
   - Implementieren `BasisPlugin` und optional zusätzliche Capabilities.

docs/DEFAULT_ROUTER.md

@@ -27,9 +27,10 @@ Typische Aktionen:
 - `play_episode_url`
 
 ## Playstate
-- Speicherort: Addon Profilordner, Datei `playstate.json`
-- Key: Plugin + Titel + Staffel + Episode
-- Werte: watched, playcount, resume_position, resume_total
+Eigenes Resume/Watched-Tracking ist deaktiviert (`addon/core/playstate.py`).
+Kodi verwaltet den Playstate vollständig selbst (Watched-Status, Resume-Position).
+Die Helfer-Funktionen in `playstate.py` (Schlüsselberechnung, Zustandsabfrage) sind
+noch vorhanden, aber `track_playback_and_update_state_async()` ist ein No-op.
 
 ## Wichtige Helper
 - Plugin Loader und Discovery

docs/PLUGIN_DEVELOPMENT.md

@@ -19,9 +19,15 @@ Jedes Plugin implementiert:
 - `genres()`
 - `popular_series()`
 - `latest_episodes(page: int = 1)`
+- `latest_titles(page: int = 1)`
 - `titles_for_genre(genre: str)`
 - `titles_for_genre_page(genre: str, page: int)`
 - `titles_for_genre_group_page(...)` / `genre_has_more(...)` (Paging / Alphabet-Gruppen)
+- `years_available()` / `titles_for_year(year, page)`
+- `countries_available()` / `titles_for_country(country, page)`
+- `collections()` / `titles_for_collection(collection, page)`
+- `tags()` / `titles_for_tag(tag, page)`
+- `random_title()`
 - `stream_link_for(...)`
 - `stream_link_for_url(...)`
 - `available_hosters_for(...)`
@@ -39,12 +45,17 @@ Wenn keine echten Staffeln existieren:
 ## Capabilities
 Ein Plugin kann Features melden ueber `capabilities()`.
 Bekannte Werte:
-- `popular_series`
-- `genres`
-- `latest_episodes`
-- `new_titles`
-- `alpha`
-- `series_catalog`
+- `popular_series`   – beliebte Serien/Filme verfügbar
+- `genres`           – Genre-Navigation
+- `latest_episodes`  – neu erschienene Episoden (`latest_episodes(page)`)
+- `new_titles`       – neu hinzugefügte Titel (`latest_titles(page)`)
+- `alpha`            – alphabetische Navigation
+- `series_catalog`   – vollständiger Serienindex
+- `year_filter`      – Filter nach Erscheinungsjahr (`years_available()`, `titles_for_year()`)
+- `country_filter`   – Filter nach Produktionsland (`countries_available()`, `titles_for_country()`)
+- `collections`      – Sammlungen/Filmreihen (`collections()`, `titles_for_collection()`)
+- `tags`             – Schlagwort-Suche (`tags()`, `titles_for_tag()`)
+- `random`           – zufälliger Titel (`random_title()`)
 
 ## Suche
 Aktuelle Regeln fuer Suchtreffer:
@@ -58,6 +69,11 @@ Siehe als Referenz:
 - `addon/plugins/serienstream_plugin.py`
 - `addon/plugins/aniworld_plugin.py`
 - `addon/plugins/topstreamfilm_plugin.py`
+- `addon/plugins/hdfilme_plugin.py`
+- `addon/plugins/kkiste_plugin.py`
+- `addon/plugins/moflix_plugin.py`
+- `addon/plugins/netzkino_plugin.py`
+- `addon/plugins/youtube_plugin.py`
 
 ## Settings
 Pro Plugin meist `*_base_url`.
@@ -68,6 +84,10 @@ Beispiele:
 - `topstream_base_url`
 - `filmpalast_base_url`
 - `doku_streams_base_url`
+- `hdfilme_base_url`
+- `kkiste_base_url`
+- `moflix_base_url`
+- `netzkino_base_url`
 
 ## Playback Flow
 1. Episode oder Film auswaehlen.

docs/PLUGIN_SYSTEM.md

@@ -19,6 +19,11 @@ Relevante Dateien:
 - `aniworld_plugin.py`
 - `filmpalast_plugin.py`
 - `dokustreams_plugin.py`
+- `hdfilme_plugin.py`
+- `kkiste_plugin.py`
+- `moflix_plugin.py`
+- `netzkino_plugin.py`
+- `youtube_plugin.py`
 - `_template_plugin.py` (Vorlage)
 
 ## Discovery Ablauf
@@ -41,12 +46,17 @@ Weitere Methoden sind optional und werden nur genutzt, wenn vorhanden.
 ## Capabilities
 Plugins koennen Features aktiv melden.
 Typische Werte:
-- `popular_series`
-- `genres`
-- `latest_episodes`
-- `new_titles`
-- `alpha`
-- `series_catalog`
+- `popular_series`   – beliebte Serien/Filme
+- `genres`           – Genre-Navigation
+- `latest_episodes`  – neu erschienene Episoden
+- `new_titles`       – neu hinzugefügte Titel (einfache Stringliste)
+- `alpha`            – alphabetische Navigation
+- `series_catalog`   – vollständiger Serienindex
+- `year_filter`      – Filter nach Erscheinungsjahr
+- `country_filter`   – Filter nach Produktionsland
+- `collections`      – Sammlungen/Filmreihen
+- `tags`             – Schlagwort-Suche
+- `random`           – zufälliger Titel
 
 Das UI zeigt nur Menues fuer aktiv gemeldete Features.
 

docs/TRAKT.md

@@ -44,7 +44,9 @@ Einstellungen
 
 Menues im Hauptmenue
 
-Wenn Trakt aktiviert und autorisiert ist, erscheinen im ViewIT-Hauptmenue folgende Eintraege:
+Wenn Trakt aktiviert ist, erscheint im ViewIT-Hauptmenue ein Untermenüpunkt "Trakt" (nach allen Quellen-Plugins).
+
+Ein Klick darauf oeffnet das Trakt-Untermenue mit folgenden Eintraegen (nur wenn bereits autorisiert):
 
 
 Weiterschauen

scripts/build_kodi_zip.sh

@@ -34,6 +34,10 @@ PY
 ZIP_NAME="${ADDON_ID}-${ADDON_VERSION}.zip"
 ZIP_PATH="${INSTALL_DIR}/${ZIP_NAME}"
 
+CHANGELOG_USER="${SRC_ADDON_DIR}/CHANGELOG-USER.md"
+python3 "${ROOT_DIR}/scripts/update_user_changelog.py" --fill  "${ADDON_XML}" "${CHANGELOG_USER}" >&2
+python3 "${ROOT_DIR}/scripts/update_user_changelog.py" --check "${ADDON_XML}" "${CHANGELOG_USER}" >&2 || exit 1
+
 ADDON_DIR="$("${ROOT_DIR}/scripts/build_install_addon.sh" >/dev/null; echo "${INSTALL_DIR}/${ADDON_ID}")"
 
 rm -f "${ZIP_PATH}"

scripts/hooks/pre-commit

@@ -51,4 +51,13 @@ fi
 sed -i "s/version=\"${current}\"/version=\"${new_version}\"/" addon/addon.xml
 git add addon/addon.xml
 
+# Changelog-Abschnitt von alter auf neue Version umbenennen (nur erstes Vorkommen)
+old_clean=$(echo "$version_only")
+new_clean=$(echo "$new_version" | sed 's/-[a-zA-Z].*$//')
+CHANGELOG="addon/CHANGELOG-USER.md"
+if [[ -f "$CHANGELOG" ]]; then
+    sed -i "0,/^## ${old_clean}$/s//## ${new_clean}/" "$CHANGELOG"
+    git add "$CHANGELOG"
+fi
+
 echo "[hook] Version: $current → $new_version"

scripts/update_user_changelog.py

@@ -0,0 +1,238 @@
+#!/usr/bin/env python3
+"""
+Pflegt CHANGELOG-USER.md vor dem ZIP-Build.
+
+Modi:
+  --fill    Liest Commits seit letztem Tag, generiert lesbaren Text und ersetzt
+            den Platzhalter im Abschnitt der aktuellen Version.
+            Legt den Abschnitt an falls noch nicht vorhanden.
+  --check   Prüft ob ein gefüllter Abschnitt für VERSION existiert.
+            Exit 0 = OK, Exit 1 = fehlt oder ist Platzhalter.
+
+Aufruf durch build_kodi_zip.sh:
+  python3 scripts/update_user_changelog.py --fill  addon/addon.xml addon/CHANGELOG-USER.md
+  python3 scripts/update_user_changelog.py --check addon/addon.xml addon/CHANGELOG-USER.md
+"""
+
+import re
+import subprocess
+import sys
+import xml.etree.ElementTree as ET
+from pathlib import Path
+
+PLACEHOLDER_LINE = "(Bitte Changelog-Einträge hier einfügen)"
+
+# Schlüsselwörter aus Commit-Messages → lesbarer Kategorie-Text
+# Reihenfolge bestimmt Priorität (erster Treffer gewinnt).
+CATEGORY_RULES: list[tuple[re.Pattern, str]] = [
+    (re.compile(r"trakt", re.I),             "Trakt"),
+    (re.compile(r"serienstream|serien.?stream", re.I), "SerienStream"),
+    (re.compile(r"aniworld", re.I),          "AniWorld"),
+    (re.compile(r"youtube|yt.?dlp", re.I),  "YouTube"),
+    (re.compile(r"tmdb|metadat", re.I),     "Metadaten"),
+    (re.compile(r"suche|search", re.I),     "Suche"),
+    (re.compile(r"setting|einstellung", re.I), "Einstellungen"),
+    (re.compile(r"update|version", re.I),   "Updates"),
+    (re.compile(r"moflix", re.I),           "Moflix"),
+    (re.compile(r"filmpalast", re.I),       "Filmpalast"),
+    (re.compile(r"kkiste", re.I),           "KKiste"),
+    (re.compile(r"doku.?stream", re.I),     "Doku-Streams"),
+    (re.compile(r"topstream", re.I),        "Topstreamfilm"),
+    (re.compile(r"einschalten", re.I),      "Einschalten"),
+    (re.compile(r"hdfilme", re.I),          "HDFilme"),
+    (re.compile(r"netzkino", re.I),         "NetzkKino"),
+]
+
+
+def get_version(addon_xml: Path) -> str:
+    root = ET.parse(addon_xml).getroot()
+    return root.attrib.get("version", "").strip()
+
+
+def strip_suffix(version: str) -> str:
+    return re.sub(r"-(dev|nightly|beta|alpha).*$", "", version)
+
+
+def get_prev_tag(current_tag: str) -> str | None:
+    try:
+        result = subprocess.run(
+            ["git", "tag", "--sort=-version:refname"],
+            capture_output=True, text=True, check=True,
+        )
+        tags = [t.strip() for t in result.stdout.splitlines() if t.strip()]
+        if current_tag in tags:
+            idx = tags.index(current_tag)
+            return tags[idx + 1] if idx + 1 < len(tags) else None
+        return tags[0] if tags else None
+    except Exception:
+        return None
+
+
+def get_commits_since(prev_tag: str | None) -> list[str]:
+    """Gibt Commit-Subjects seit prev_tag zurück (ohne den Tag-Commit selbst)."""
+    try:
+        ref = f"{prev_tag}..HEAD" if prev_tag else "HEAD"
+        result = subprocess.run(
+            ["git", "log", ref, "--pretty=format:%s"],
+            capture_output=True, text=True, check=True,
+        )
+        return [l.strip() for l in result.stdout.splitlines() if l.strip()]
+    except Exception:
+        return []
+
+
+def extract_description(subject: str) -> str:
+    """Extrahiert den lesbaren Teil aus einer Commit-Message."""
+    # "dev: bump to 0.1.86.0-dev Beschreibung hier" → "Beschreibung hier"
+    m = re.match(r"^(?:dev|nightly|main):\s*bump\s+to\s+[\d.]+(?:-\w+)?\s*(.+)$", subject, re.I)
+    if m:
+        return m.group(1).strip()
+    # "dev: Beschreibung" → "Beschreibung"
+    m = re.match(r"^(?:dev|nightly|main):\s*(.+)$", subject, re.I)
+    if m:
+        return m.group(1).strip()
+    return subject
+
+
+def split_description(desc: str) -> list[str]:
+    """Zerlegt kommagetrennte Beschreibungen in Einzelpunkte."""
+    parts = [p.strip() for p in re.split(r",\s*(?=[A-ZÄÖÜ\w])", desc) if p.strip()]
+    return parts if parts else [desc]
+
+
+def categorize(items: list[str]) -> dict[str, list[str]]:
+    """Gruppiert Beschreibungs-Punkte nach Kategorie."""
+    categories: dict[str, list[str]] = {}
+    for item in items:
+        cat = "Allgemein"
+        for pattern, label in CATEGORY_RULES:
+            if pattern.search(item):
+                cat = label
+                break
+        categories.setdefault(cat, []).append(item)
+    return categories
+
+
+def build_changelog_text(commits: list[str]) -> str:
+    """Erzeugt lesbaren Changelog-Text aus Commit-Subjects."""
+    all_items: list[str] = []
+    for subject in commits:
+        desc = extract_description(subject)
+        if desc:
+            all_items.extend(split_description(desc))
+
+    if not all_items:
+        return "- Verschiedene Verbesserungen und Fehlerbehebungen"
+
+    categories = categorize(all_items)
+    lines: list[str] = []
+    for cat, items in categories.items():
+        lines.append(f"**{cat}**")
+        for item in items:
+            # Ersten Buchstaben groß, Punkt am Ende
+            item = item[0].upper() + item[1:] if item else item
+            if not item.endswith((".","!","?")):
+                item += "."
+            lines.append(f"- {item}")
+        lines.append("")
+    return "\n".join(lines).rstrip()
+
+
+def section_exists(lines: list[str], header: str) -> bool:
+    return any(line.strip() == header for line in lines)
+
+
+def section_is_placeholder(lines: list[str], header: str) -> bool:
+    in_section = False
+    content_lines = []
+    for line in lines:
+        if line.strip() == header:
+            in_section = True
+            continue
+        if in_section:
+            if line.startswith("## "):
+                break
+            stripped = line.strip()
+            if stripped:
+                content_lines.append(stripped)
+    return not content_lines or all(l == PLACEHOLDER_LINE for l in content_lines)
+
+
+def replace_section_content(lines: list[str], header: str, new_content: str) -> list[str]:
+    """Ersetzt den Inhalt eines bestehenden Abschnitts."""
+    result: list[str] = []
+    in_section = False
+    content_written = False
+    for line in lines:
+        if line.strip() == header:
+            result.append(line)
+            result.append("")
+            result.extend(new_content.splitlines())
+            result.append("")
+            in_section = True
+            content_written = True
+            continue
+        if in_section:
+            if line.startswith("## "):
+                in_section = False
+                result.append(line)
+            # Alte Zeilen des Abschnitts überspringen
+            continue
+        result.append(line)
+    return result
+
+
+def insert_section(lines: list[str], header: str, content: str) -> list[str]:
+    new_section = [header, "", *content.splitlines(), ""]
+    return new_section + ([""] if lines and lines[0].strip() else []) + lines
+
+
+def main() -> None:
+    if len(sys.argv) < 4 or sys.argv[1] not in ("--fill", "--check"):
+        print(f"Usage: {sys.argv[0]} --fill|--check <addon.xml> <CHANGELOG-USER.md>", file=sys.stderr)
+        sys.exit(2)
+
+    mode = sys.argv[1]
+    addon_xml = Path(sys.argv[2])
+    changelog = Path(sys.argv[3])
+
+    version = get_version(addon_xml)
+    if not version:
+        print("Fehler: Version konnte nicht aus addon.xml gelesen werden.", file=sys.stderr)
+        sys.exit(2)
+
+    clean_version = strip_suffix(version)
+    header = f"## {clean_version}"
+    lines = changelog.read_text(encoding="utf-8").splitlines() if changelog.exists() else []
+
+    if mode == "--check":
+        if not section_exists(lines, header):
+            print(f"FEHLER: Kein Changelog-Abschnitt für {clean_version} in {changelog}", file=sys.stderr)
+            sys.exit(1)
+        if section_is_placeholder(lines, header):
+            print(f"FEHLER: Changelog-Abschnitt für {clean_version} ist noch ein Platzhalter.", file=sys.stderr)
+            sys.exit(1)
+        print(f"OK: Changelog-Abschnitt für {clean_version} vorhanden.")
+        sys.exit(0)
+
+    # --fill
+    current_tag = f"v{version}"
+    prev_tag = get_prev_tag(current_tag)
+    commits = get_commits_since(prev_tag)
+    content = build_changelog_text(commits)
+
+    if section_exists(lines, header):
+        if not section_is_placeholder(lines, header):
+            print(f"Abschnitt {header} bereits gefüllt – keine Änderung.")
+            sys.exit(0)
+        new_lines = replace_section_content(lines, header, content)
+    else:
+        new_lines = insert_section(lines, header, content)
+
+    changelog.write_text("\n".join(new_lines) + "\n", encoding="utf-8")
+    print(f"Changelog für {header} geschrieben.")
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()