dev: bump to 0.1.87.0-dev Trakt-Untermenue, Weiterschauen-Fixes, Scrobbling zuverlässig

CHANGELOG-DEV.md

@@ -1,3 +1,11 @@
+## 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

addon/CHANGELOG-USER.md

@@ -0,0 +1,39 @@
+## 0.1.86.5
+
+**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
+
+**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
+
+## 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.86.0-dev" provider-name="ViewIt">
+<addon id="plugin.video.viewit" name="ViewIt" version="0.1.87.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)
@@ -387,19 +389,26 @@ class TraktClient:
             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
@@ -461,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

@@ -132,6 +132,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
@@ -1064,6 +1066,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}, {}
@@ -1845,18 +1853,25 @@ 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)
 
     _add_directory_item(handle, "Einstellungen", "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)
+        _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)
+
+
 def _show_plugin_menu(plugin_name: str) -> None:
     handle = _get_handle()
     plugin_name = (plugin_name or "").strip()
@@ -2189,6 +2204,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()
@@ -2213,7 +2251,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):
@@ -2318,7 +2356,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,
@@ -2329,8 +2367,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,
@@ -4280,8 +4319,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
@@ -4302,7 +4343,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:
@@ -4344,9 +4387,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:
@@ -4475,6 +4527,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,
@@ -5217,8 +5278,17 @@ def _show_trakt_continue_watching() -> None:
     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
+        # 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})"
@@ -5486,6 +5556,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()
@@ -5559,6 +5634,38 @@ 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")
@@ -5566,6 +5673,8 @@ def run() -> None:
     _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/resources/settings.xml

@@ -6,6 +6,20 @@
     <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" />
@@ -127,4 +141,8 @@
     <setting id="log_errors_filmpalast" type="bool" label="Filmpalast: Fehler mitschreiben" default="false" />
   </category>
 
+  <category label="Intern">
+    <setting id="changelog_last_shown_version" type="text" label="" default="" visible="false" />
+  </category>
+
 </settings>

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/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()