Add Doku-Streams plugin and prefer source metadata

addon/default.py

@@ -958,6 +958,57 @@ def _update_repository_source(info_url: str) -> bool:
         return False
 
 
+def _settings_key_for_plugin(name: str) -> str:
+    safe = re.sub(r"[^a-z0-9]+", "_", (name or "").strip().casefold()).strip("_")
+    return f"update_version_{safe}" if safe else "update_version_unknown"
+
+
+def _collect_plugin_metadata(plugin: BasisPlugin, titles: list[str]) -> dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember] | None]]:
+    getter = getattr(plugin, "metadata_for", None)
+    if not callable(getter):
+        return {}
+    collected: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember] | None]] = {}
+    for title in titles:
+        try:
+            labels, art, cast = getter(title)
+        except Exception:
+            continue
+        if isinstance(labels, dict) or isinstance(art, dict) or cast:
+            label_map = {str(k): str(v) for k, v in dict(labels or {}).items() if v}
+            art_map = {str(k): str(v) for k, v in dict(art or {}).items() if v}
+            collected[title] = (label_map, art_map, cast if isinstance(cast, list) else None)
+    return collected
+
+
+def _needs_tmdb(labels: dict[str, str], art: dict[str, str], *, want_plot: bool, want_art: bool) -> bool:
+    if want_plot and not labels.get("plot"):
+        return True
+    if want_art and not (art.get("thumb") or art.get("poster") or art.get("fanart") or art.get("landscape")):
+        return True
+    return False
+
+
+def _merge_metadata(
+    title: str,
+    tmdb_labels: dict[str, str] | None,
+    tmdb_art: dict[str, str] | None,
+    tmdb_cast: list[TmdbCastMember] | None,
+    plugin_meta: tuple[dict[str, str], dict[str, str], list[TmdbCastMember] | None] | None,
+) -> tuple[dict[str, str], dict[str, str], list[TmdbCastMember] | None]:
+    labels = dict(tmdb_labels or {})
+    art = dict(tmdb_art or {})
+    cast = tmdb_cast
+    if plugin_meta is not None:
+        meta_labels, meta_art, meta_cast = plugin_meta
+        labels.update({k: str(v) for k, v in dict(meta_labels or {}).items() if v})
+        art.update({k: str(v) for k, v in dict(meta_art or {}).items() if v})
+        if meta_cast is not None:
+            cast = meta_cast
+    if "title" not in labels:
+        labels["title"] = title
+    return labels, art, cast
+
+
 def _sync_update_version_settings() -> None:
     addon = _get_addon()
     addon_version = "0.0.0"
@@ -974,9 +1025,10 @@ def _sync_update_version_settings() -> None:
         "update_version_einschalten": "-",
         "update_version_topstreamfilm": "-",
         "update_version_filmpalast": "-",
+        "update_version_doku_streams": "-",
     }
     for plugin in _discover_plugins().values():
-        key = f"update_version_{str(plugin.name).strip().lower()}"
+        key = _settings_key_for_plugin(str(plugin.name))
         if key in versions:
             versions[key] = _plugin_version(plugin)
     for key, value in versions.items():
@@ -1072,10 +1124,24 @@ def _show_plugin_search_results(plugin_name: str, query: str) -> None:
             results = [str(t).strip() for t in (results or []) if t and str(t).strip()]
             results.sort(key=lambda value: value.casefold())
 
+            plugin_meta = _collect_plugin_metadata(plugin, results)
             tmdb_prefetched: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember]]] = {}
-            if results and not canceled:
+            show_tmdb = _tmdb_enabled()
+            show_plot = _get_setting_bool("tmdb_show_plot", default=True)
+            show_art = _get_setting_bool("tmdb_show_art", default=True)
+            prefer_source = bool(getattr(plugin, "prefer_source_metadata", False))
+            tmdb_titles = list(results)
+            if show_tmdb and prefer_source:
+                tmdb_titles = []
+                for title in results:
+                    meta = plugin_meta.get(title)
+                    meta_labels = meta[0] if meta else {}
+                    meta_art = meta[1] if meta else {}
+                    if _needs_tmdb(meta_labels, meta_art, want_plot=show_plot, want_art=show_art):
+                        tmdb_titles.append(title)
+            if show_tmdb and tmdb_titles and not canceled:
                 canceled = progress(35, f"{plugin_name} (1/1) Metadaten…")
-                tmdb_prefetched = _tmdb_labels_and_art_bulk(list(results))
+                tmdb_prefetched = _tmdb_labels_and_art_bulk(list(tmdb_titles))
 
             total_results = max(1, len(results))
             for index, title in enumerate(results, start=1):
@@ -1084,8 +1150,9 @@ def _show_plugin_search_results(plugin_name: str, query: str) -> None:
                 if index == 1 or index == total_results or (index % 10 == 0):
                     pct = 35 + int((index / float(total_results)) * 60)
                     canceled = progress(pct, f"{plugin_name} (1/1) aufbereiten {index}/{total_results}")
-                info_labels, art, cast = tmdb_prefetched.get(title, _tmdb_labels_and_art(title))
+                tmdb_info, tmdb_art, tmdb_cast = tmdb_prefetched.get(title, ({}, {}, []))
-                info_labels = dict(info_labels or {})
+                meta = plugin_meta.get(title)
+                info_labels, art, cast = _merge_metadata(title, tmdb_info, tmdb_art, tmdb_cast, meta)
                 info_labels.setdefault("mediatype", "tvshow")
                 if (info_labels.get("mediatype") or "").strip().casefold() == "tvshow":
                     info_labels.setdefault("tvshowtitle", title)
@@ -1248,15 +1315,29 @@ def _show_search_results(query: str) -> None:
                 continue
             results = [str(t).strip() for t in (results or []) if t and str(t).strip()]
             _log(f"Treffer ({plugin_name}): {len(results)}", xbmc.LOGDEBUG)
+            plugin_meta = _collect_plugin_metadata(plugin, results)
             tmdb_prefetched: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember]]] = {}
-            if results:
+            show_tmdb = _tmdb_enabled()
+            show_plot = _get_setting_bool("tmdb_show_plot", default=True)
+            show_art = _get_setting_bool("tmdb_show_art", default=True)
+            prefer_source = bool(getattr(plugin, "prefer_source_metadata", False))
+            tmdb_titles = list(results)
+            if show_tmdb and prefer_source:
+                tmdb_titles = []
+                for title in results:
+                    meta = plugin_meta.get(title)
+                    meta_labels = meta[0] if meta else {}
+                    meta_art = meta[1] if meta else {}
+                    if _needs_tmdb(meta_labels, meta_art, want_plot=show_plot, want_art=show_art):
+                        tmdb_titles.append(title)
+            if show_tmdb and tmdb_titles:
                 canceled = progress(
                     range_start + int((range_end - range_start) * 0.35),
                     f"{plugin_name} ({plugin_index}/{total_plugins}) Metadaten…",
                 )
                 if canceled:
                     break
-                tmdb_prefetched = _tmdb_labels_and_art_bulk(list(results))
+                tmdb_prefetched = _tmdb_labels_and_art_bulk(list(tmdb_titles))
             total_results = max(1, len(results))
             for title_index, title in enumerate(results, start=1):
                 if title_index == 1 or title_index == total_results or (title_index % 10 == 0):
@@ -1266,8 +1347,9 @@ def _show_search_results(query: str) -> None:
                     )
                     if canceled:
                         break
-                info_labels, art, cast = tmdb_prefetched.get(title, _tmdb_labels_and_art(title))
+                tmdb_info, tmdb_art, tmdb_cast = tmdb_prefetched.get(title, ({}, {}, []))
-                info_labels = dict(info_labels or {})
+                meta = plugin_meta.get(title)
+                info_labels, art, cast = _merge_metadata(title, tmdb_info, tmdb_art, tmdb_cast, meta)
                 info_labels.setdefault("mediatype", "tvshow")
                 if (info_labels.get("mediatype") or "").strip().casefold() == "tvshow":
                     info_labels.setdefault("tvshowtitle", title)
@@ -1619,6 +1701,176 @@ def _show_genres(plugin_name: str) -> None:
     xbmcplugin.endOfDirectory(handle)
 
 
+def _show_categories(plugin_name: str) -> None:
+    handle = _get_handle()
+    _log(f"Kategorien laden: {plugin_name}")
+    plugin = _discover_plugins().get(plugin_name)
+    if plugin is None:
+        xbmcgui.Dialog().notification("Kategorien", "Plugin nicht gefunden.", xbmcgui.NOTIFICATION_INFO, 3000)
+        xbmcplugin.endOfDirectory(handle)
+        return
+    getter = getattr(plugin, "categories", None)
+    if not callable(getter):
+        xbmcgui.Dialog().notification("Kategorien", "Kategorien nicht verfuegbar.", xbmcgui.NOTIFICATION_INFO, 3000)
+        xbmcplugin.endOfDirectory(handle)
+        return
+    try:
+        categories = list(getter() or [])
+    except Exception as exc:
+        _log(f"Kategorien konnten nicht geladen werden ({plugin_name}): {exc}", xbmc.LOGWARNING)
+        xbmcgui.Dialog().notification("Kategorien", "Kategorien konnten nicht geladen werden.", xbmcgui.NOTIFICATION_INFO, 3000)
+        xbmcplugin.endOfDirectory(handle)
+        return
+    for category in categories:
+        category = str(category).strip()
+        if not category:
+            continue
+        _add_directory_item(
+            handle,
+            category,
+            "category_titles_page",
+            {"plugin": plugin_name, "category": category, "page": "1"},
+            is_folder=True,
+        )
+    xbmcplugin.endOfDirectory(handle)
+
+
+def _show_category_titles_page(plugin_name: str, category: str, page: int = 1) -> None:
+    handle = _get_handle()
+    plugin = _discover_plugins().get(plugin_name)
+    if plugin is None:
+        xbmcgui.Dialog().notification("Kategorien", "Plugin nicht gefunden.", xbmcgui.NOTIFICATION_INFO, 3000)
+        xbmcplugin.endOfDirectory(handle)
+        return
+
+    page = max(1, int(page or 1))
+    paging_getter = getattr(plugin, "titles_for_genre_page", None)
+    if not callable(paging_getter):
+        xbmcgui.Dialog().notification("Kategorien", "Paging nicht verfuegbar.", xbmcgui.NOTIFICATION_INFO, 3000)
+        xbmcplugin.endOfDirectory(handle)
+        return
+
+    total_pages = None
+    count_getter = getattr(plugin, "genre_page_count", None)
+    if callable(count_getter):
+        try:
+            total_pages = int(count_getter(category) or 1)
+        except Exception:
+            total_pages = None
+    if total_pages is not None:
+        page = min(page, max(1, total_pages))
+        xbmcplugin.setPluginCategory(handle, f"{category} ({page}/{total_pages})")
+    else:
+        xbmcplugin.setPluginCategory(handle, f"{category} ({page})")
+    _set_content(handle, "movies" if (plugin_name or "").casefold() == "einschalten" else "tvshows")
+
+    if page > 1:
+        _add_directory_item(
+            handle,
+            "Vorherige Seite",
+            "category_titles_page",
+            {"plugin": plugin_name, "category": category, "page": str(page - 1)},
+            is_folder=True,
+        )
+
+    try:
+        titles = list(paging_getter(category, page) or [])
+    except Exception as exc:
+        _log(f"Kategorie-Seite konnte nicht geladen werden ({plugin_name}/{category} p{page}): {exc}", xbmc.LOGWARNING)
+        xbmcgui.Dialog().notification("Kategorien", "Seite konnte nicht geladen werden.", xbmcgui.NOTIFICATION_INFO, 3000)
+        xbmcplugin.endOfDirectory(handle)
+        return
+
+    titles = [str(t).strip() for t in titles if t and str(t).strip()]
+    titles.sort(key=lambda value: value.casefold())
+
+    show_tmdb = _get_setting_bool("tmdb_genre_metadata", default=False)
+    if titles:
+        plugin_meta = _collect_plugin_metadata(plugin, titles)
+        show_tmdb = _tmdb_enabled()
+        show_plot = _get_setting_bool("tmdb_show_plot", default=True)
+        show_art = _get_setting_bool("tmdb_show_art", default=True)
+        prefer_source = bool(getattr(plugin, "prefer_source_metadata", False))
+        tmdb_prefetched: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember]]] = {}
+        tmdb_titles = list(titles)
+        if show_tmdb and prefer_source:
+            tmdb_titles = []
+            for title in titles:
+                meta = plugin_meta.get(title)
+                meta_labels = meta[0] if meta else {}
+                meta_art = meta[1] if meta else {}
+                if _needs_tmdb(meta_labels, meta_art, want_plot=show_plot, want_art=show_art):
+                    tmdb_titles.append(title)
+        if show_tmdb and tmdb_titles:
+            with _busy_dialog():
+                tmdb_prefetched = _tmdb_labels_and_art_bulk(tmdb_titles)
+        if show_tmdb:
+            for title in titles:
+                tmdb_info, tmdb_art, tmdb_cast = tmdb_prefetched.get(title, ({}, {}, []))
+                meta = plugin_meta.get(title)
+                info_labels, art, cast = _merge_metadata(title, tmdb_info, tmdb_art, tmdb_cast, meta)
+                info_labels.setdefault("mediatype", "tvshow")
+                if (info_labels.get("mediatype") or "").strip().casefold() == "tvshow":
+                    info_labels.setdefault("tvshowtitle", title)
+                playstate = _title_playstate(plugin_name, title)
+                info_labels = _apply_playstate_to_info(dict(info_labels), playstate)
+                display_label = _label_with_duration(title, info_labels)
+                display_label = _label_with_playstate(display_label, playstate)
+                direct_play = bool(
+                    plugin_name.casefold() == "einschalten"
+                    and _get_setting_bool("einschalten_enable_playback", default=False)
+                )
+                _add_directory_item(
+                    handle,
+                    display_label,
+                    "play_movie" if direct_play else "seasons",
+                    {"plugin": plugin_name, "title": title, **_series_url_params(plugin, title)},
+                    is_folder=not direct_play,
+                    info_labels=info_labels,
+                    art=art,
+                    cast=cast,
+                )
+        else:
+            for title in titles:
+                playstate = _title_playstate(plugin_name, title)
+                meta = plugin_meta.get(title)
+                info_labels, art, cast = _merge_metadata(title, {}, {}, None, meta)
+                direct_play = bool(
+                    plugin_name.casefold() == "einschalten"
+                    and _get_setting_bool("einschalten_enable_playback", default=False)
+                )
+                _add_directory_item(
+                    handle,
+                    _label_with_playstate(title, playstate),
+                    "play_movie" if direct_play else "seasons",
+                    {"plugin": plugin_name, "title": title, **_series_url_params(plugin, title)},
+                    is_folder=not direct_play,
+                    info_labels=_apply_playstate_to_info(info_labels, playstate),
+                    art=art,
+                    cast=cast,
+                )
+
+    show_next = False
+    if total_pages is not None:
+        show_next = page < total_pages
+    else:
+        has_more_getter = getattr(plugin, "genre_has_more", None)
+        if callable(has_more_getter):
+            try:
+                show_next = bool(has_more_getter(category, page))
+            except Exception:
+                show_next = False
+
+    if show_next:
+        _add_directory_item(
+            handle,
+            "Nächste Seite",
+            "category_titles_page",
+            {"plugin": plugin_name, "category": category, "page": str(page + 1)},
+            is_folder=True,
+        )
+    xbmcplugin.endOfDirectory(handle)
+
 def _show_genre_titles_page(plugin_name: str, genre: str, page: int = 1) -> None:
     handle = _get_handle()
     plugin = _discover_plugins().get(plugin_name)
@@ -1670,12 +1922,28 @@ def _show_genre_titles_page(plugin_name: str, genre: str, page: int = 1) -> None
 
     show_tmdb = _get_setting_bool("tmdb_genre_metadata", default=False)
     if titles:
-        if show_tmdb:
+        plugin_meta = _collect_plugin_metadata(plugin, titles)
-            with _busy_dialog():
+        show_tmdb = show_tmdb and _tmdb_enabled()
-                tmdb_prefetched = _tmdb_labels_and_art_bulk(titles)
+        show_plot = _get_setting_bool("tmdb_show_plot", default=True)
+        show_art = _get_setting_bool("tmdb_show_art", default=True)
+        prefer_source = bool(getattr(plugin, "prefer_source_metadata", False))
+        tmdb_prefetched: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember]]] = {}
+        tmdb_titles = list(titles)
+        if show_tmdb and prefer_source:
+            tmdb_titles = []
             for title in titles:
-                    info_labels, art, cast = tmdb_prefetched.get(title, _tmdb_labels_and_art(title))
+                meta = plugin_meta.get(title)
-                    info_labels = dict(info_labels or {})
+                meta_labels = meta[0] if meta else {}
+                meta_art = meta[1] if meta else {}
+                if _needs_tmdb(meta_labels, meta_art, want_plot=show_plot, want_art=show_art):
+                    tmdb_titles.append(title)
+        if show_tmdb and tmdb_titles:
+            with _busy_dialog():
+                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.setdefault("mediatype", "tvshow")
             if (info_labels.get("mediatype") or "").strip().casefold() == "tvshow":
                 info_labels.setdefault("tvshowtitle", title)
@@ -1697,21 +1965,6 @@ def _show_genre_titles_page(plugin_name: str, genre: str, page: int = 1) -> None
                 art=art,
                 cast=cast,
             )
-        else:
-            for title in titles:
-                playstate = _title_playstate(plugin_name, title)
-                direct_play = bool(
-                    plugin_name.casefold() == "einschalten"
-                    and _get_setting_bool("einschalten_enable_playback", default=False)
-                )
-                _add_directory_item(
-                    handle,
-                    _label_with_playstate(title, playstate),
-                    "play_movie" if direct_play else "seasons",
-                    {"plugin": plugin_name, "title": title, **_series_url_params(plugin, title)},
-                    is_folder=not direct_play,
-                    info_labels=_apply_playstate_to_info({"title": title}, playstate),
-                )
 
     show_next = False
     if total_pages is not None:
@@ -2159,12 +2412,28 @@ def _show_popular(plugin_name: str | None = None, page: int = 1) -> None:
 
         show_tmdb = _get_setting_bool("tmdb_genre_metadata", default=False)
         if page_items:
-            if show_tmdb:
+            plugin_meta = _collect_plugin_metadata(plugin, page_items)
-                with _busy_dialog():
+            show_tmdb = show_tmdb and _tmdb_enabled()
-                    tmdb_prefetched = _tmdb_labels_and_art_bulk(page_items)
+            show_plot = _get_setting_bool("tmdb_show_plot", default=True)
+            show_art = _get_setting_bool("tmdb_show_art", default=True)
+            prefer_source = bool(getattr(plugin, "prefer_source_metadata", False))
+            tmdb_prefetched: dict[str, tuple[dict[str, str], dict[str, str], list[TmdbCastMember]]] = {}
+            tmdb_titles = list(page_items)
+            if show_tmdb and prefer_source:
+                tmdb_titles = []
                 for title in page_items:
-                        info_labels, art, cast = tmdb_prefetched.get(title, _tmdb_labels_and_art(title))
+                    meta = plugin_meta.get(title)
-                        info_labels = dict(info_labels or {})
+                    meta_labels = meta[0] if meta else {}
+                    meta_art = meta[1] if meta else {}
+                    if _needs_tmdb(meta_labels, meta_art, want_plot=show_plot, want_art=show_art):
+                        tmdb_titles.append(title)
+            if show_tmdb and tmdb_titles:
+                with _busy_dialog():
+                    tmdb_prefetched = _tmdb_labels_and_art_bulk(tmdb_titles)
+            for title in page_items:
+                tmdb_info, tmdb_art, tmdb_cast = tmdb_prefetched.get(title, ({}, {}, []))
+                meta = plugin_meta.get(title)
+                info_labels, art, cast = _merge_metadata(title, tmdb_info, tmdb_art, tmdb_cast, meta)
                 info_labels.setdefault("mediatype", "tvshow")
                 if (info_labels.get("mediatype") or "").strip().casefold() == "tvshow":
                     info_labels.setdefault("tvshowtitle", title)
@@ -2182,17 +2451,6 @@ def _show_popular(plugin_name: str | None = None, page: int = 1) -> None:
                     art=art,
                     cast=cast,
                 )
-            else:
-                for title in page_items:
-                    playstate = _title_playstate(plugin_name, title)
-                    _add_directory_item(
-                        handle,
-                        _label_with_playstate(title, playstate),
-                        "seasons",
-                        {"plugin": plugin_name, "title": title, **_series_url_params(plugin, title)},
-                        is_folder=True,
-                        info_labels=_apply_playstate_to_info({"title": title}, playstate),
-                    )
 
         if total_pages > 1 and page < total_pages:
             _add_directory_item(
@@ -2945,6 +3203,8 @@ def run() -> None:
         _show_genre_sources()
     elif action == "genres":
         _show_genres(params.get("plugin", ""))
+    elif action == "categories":
+        _show_categories(params.get("plugin", ""))
     elif action == "new_titles":
         _show_new_titles(
             params.get("plugin", ""),
@@ -2966,6 +3226,12 @@ def run() -> None:
             params.get("genre", ""),
             _parse_positive_int(params.get("page", "1"), default=1),
         )
+    elif action == "category_titles_page":
+        _show_category_titles_page(
+            params.get("plugin", ""),
+            params.get("category", ""),
+            _parse_positive_int(params.get("page", "1"), default=1),
+        )
     elif action == "alpha_index":
         _show_alpha_index(params.get("plugin", ""))
     elif action == "alpha_titles_page":

addon/plugins/dokustreams_plugin.py

@@ -0,0 +1,476 @@
+"""Doku-Streams (doku-streams.com) Integration."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+import re
+from urllib.parse import quote
+from typing import TYPE_CHECKING, Any, Dict, List, Optional, TypeAlias
+
+try:  # pragma: no cover - optional dependency
+    import requests
+    from bs4 import BeautifulSoup  # type: ignore[import-not-found]
+except ImportError as exc:  # pragma: no cover - optional dependency
+    requests = None
+    BeautifulSoup = None
+    REQUESTS_AVAILABLE = False
+    REQUESTS_IMPORT_ERROR = exc
+else:
+    REQUESTS_AVAILABLE = True
+    REQUESTS_IMPORT_ERROR = None
+
+from plugin_interface import BasisPlugin
+from plugin_helpers import dump_response_html, get_setting_bool, get_setting_string, log_error, log_url, notify_url
+from http_session_pool import get_requests_session
+
+if TYPE_CHECKING:  # pragma: no cover
+    from requests import Session as RequestsSession
+    from bs4 import BeautifulSoup as BeautifulSoupT  # type: ignore[import-not-found]
+else:  # pragma: no cover
+    RequestsSession: TypeAlias = Any
+    BeautifulSoupT: TypeAlias = Any
+
+
+ADDON_ID = "plugin.video.viewit"
+SETTING_BASE_URL = "doku_streams_base_url"
+DEFAULT_BASE_URL = "https://doku-streams.com"
+MOST_VIEWED_PATH = "/meistgesehene/"
+DEFAULT_TIMEOUT = 20
+GLOBAL_SETTING_LOG_URLS = "debug_log_urls"
+GLOBAL_SETTING_DUMP_HTML = "debug_dump_html"
+GLOBAL_SETTING_SHOW_URL_INFO = "debug_show_url_info"
+GLOBAL_SETTING_LOG_ERRORS = "debug_log_errors"
+SETTING_LOG_URLS = "log_urls_dokustreams"
+SETTING_DUMP_HTML = "dump_html_dokustreams"
+SETTING_SHOW_URL_INFO = "show_url_info_dokustreams"
+SETTING_LOG_ERRORS = "log_errors_dokustreams"
+HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Kodi; ViewIt) AppleWebKit/537.36 (KHTML, like Gecko)",
+    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+    "Accept-Language": "de-DE,de;q=0.9,en;q=0.8",
+    "Connection": "keep-alive",
+}
+
+
+@dataclass(frozen=True)
+class SearchHit:
+    title: str
+    url: str
+    plot: str = ""
+    poster: str = ""
+
+
+def _extract_last_page(soup: BeautifulSoupT) -> int:
+    max_page = 1
+    if not soup:
+        return max_page
+    for anchor in soup.select("nav.navigation a[href], nav.pagination a[href], a.page-numbers[href]"):
+        text = (anchor.get_text(" ", strip=True) or "").strip()
+        for candidate in (text, (anchor.get("href") or "").strip()):
+            for value in re.findall(r"/page/(\\d+)/", candidate):
+                try:
+                    max_page = max(max_page, int(value))
+                except Exception:
+                    continue
+            for value in re.findall(r"(\\d+)", candidate):
+                try:
+                    max_page = max(max_page, int(value))
+                except Exception:
+                    continue
+    return max_page
+
+
+def _extract_summary_and_poster(article: BeautifulSoupT) -> tuple[str, str]:
+    summary = ""
+    if article:
+        summary_box = article.select_one("div.entry-summary")
+        if summary_box is not None:
+            for p in summary_box.find_all("p"):
+                text = (p.get_text(" ", strip=True) or "").strip()
+                if text:
+                    summary = text
+                    break
+    poster = ""
+    if article:
+        img = article.select_one("div.entry-thumb img")
+        if img is not None:
+            poster = (img.get("data-src") or "").strip() or (img.get("src") or "").strip()
+            if "lazy_placeholder" in poster and img.get("data-src"):
+                poster = (img.get("data-src") or "").strip()
+            poster = _absolute_url(poster)
+    return summary, poster
+
+
+def _parse_listing_hits(soup: BeautifulSoupT, *, query: str = "") -> List[SearchHit]:
+    hits: List[SearchHit] = []
+    if not soup:
+        return hits
+    seen_titles: set[str] = set()
+    seen_urls: set[str] = set()
+    for article in soup.select("article[id^='post-']"):
+        anchor = article.select_one("h2.entry-title a[href]")
+        if anchor is None:
+            continue
+        href = (anchor.get("href") or "").strip()
+        title = (anchor.get_text(" ", strip=True) or "").strip()
+        if not href or not title:
+            continue
+        if query and not _matches_query(query, title=title):
+            continue
+        url = _absolute_url(href).split("#", 1)[0].split("?", 1)[0].rstrip("/")
+        title_key = title.casefold()
+        url_key = url.casefold()
+        if title_key in seen_titles or url_key in seen_urls:
+            continue
+        seen_titles.add(title_key)
+        seen_urls.add(url_key)
+        _log_url_event(url, kind="PARSE")
+        summary, poster = _extract_summary_and_poster(article)
+        hits.append(SearchHit(title=title, url=url, plot=summary, poster=poster))
+    return hits
+
+
+def _get_base_url() -> str:
+    base = get_setting_string(ADDON_ID, SETTING_BASE_URL, default=DEFAULT_BASE_URL).strip()
+    if not base:
+        base = DEFAULT_BASE_URL
+    return base.rstrip("/")
+
+
+def _absolute_url(url: str) -> str:
+    url = (url or "").strip()
+    if not url:
+        return ""
+    if url.startswith("http://") or url.startswith("https://"):
+        return url
+    if url.startswith("//"):
+        return f"https:{url}"
+    if url.startswith("/"):
+        return f"{_get_base_url()}{url}"
+    return f"{_get_base_url()}/{url.lstrip('/')}"
+
+
+def _normalize_search_text(value: str) -> str:
+    value = (value or "").casefold()
+    value = re.sub(r"[^a-z0-9]+", " ", value)
+    value = re.sub(r"\s+", " ", value).strip()
+    return value
+
+
+def _matches_query(query: str, *, title: str) -> bool:
+    normalized_query = _normalize_search_text(query)
+    if not normalized_query:
+        return False
+    haystack = f" {_normalize_search_text(title)} "
+    return f" {normalized_query} " in haystack
+
+
+def _log_url_event(url: str, *, kind: str = "VISIT") -> None:
+    log_url(
+        ADDON_ID,
+        enabled_setting_id=GLOBAL_SETTING_LOG_URLS,
+        plugin_setting_id=SETTING_LOG_URLS,
+        log_filename="dokustreams_urls.log",
+        url=url,
+        kind=kind,
+    )
+
+
+def _log_visit(url: str) -> None:
+    _log_url_event(url, kind="VISIT")
+    notify_url(
+        ADDON_ID,
+        heading="Doku-Streams",
+        url=url,
+        enabled_setting_id=GLOBAL_SETTING_SHOW_URL_INFO,
+        plugin_setting_id=SETTING_SHOW_URL_INFO,
+    )
+
+
+def _log_response_html(url: str, body: str) -> None:
+    dump_response_html(
+        ADDON_ID,
+        enabled_setting_id=GLOBAL_SETTING_DUMP_HTML,
+        plugin_setting_id=SETTING_DUMP_HTML,
+        url=url,
+        body=body,
+        filename_prefix="dokustreams_response",
+    )
+
+
+def _log_error_message(message: str) -> None:
+    log_error(
+        ADDON_ID,
+        enabled_setting_id=GLOBAL_SETTING_LOG_ERRORS,
+        plugin_setting_id=SETTING_LOG_ERRORS,
+        log_filename="dokustreams_errors.log",
+        message=message,
+    )
+
+
+def _get_soup(url: str, *, session: Optional[RequestsSession] = None) -> BeautifulSoupT:
+    if requests is None or BeautifulSoup is None:
+        raise RuntimeError("requests/bs4 sind nicht verfuegbar.")
+    _log_visit(url)
+    sess = session or get_requests_session("dokustreams", headers=HEADERS)
+    try:
+        response = sess.get(url, headers=HEADERS, timeout=DEFAULT_TIMEOUT)
+        response.raise_for_status()
+    except Exception as exc:
+        _log_error_message(f"GET {url} failed: {exc}")
+        raise
+    if response.url and response.url != url:
+        _log_url_event(response.url, kind="REDIRECT")
+    _log_response_html(url, response.text)
+    return BeautifulSoup(response.text, "html.parser")
+
+
+class DokuStreamsPlugin(BasisPlugin):
+    name = "Doku-Streams"
+    version = "1.0.0"
+    prefer_source_metadata = True
+
+    def __init__(self) -> None:
+        self._title_to_url: Dict[str, str] = {}
+        self._category_to_url: Dict[str, str] = {}
+        self._category_page_count_cache: Dict[str, int] = {}
+        self._popular_cache: Optional[List[SearchHit]] = None
+        self._title_meta: Dict[str, tuple[str, str]] = {}
+        self._requests_available = REQUESTS_AVAILABLE
+        self.is_available = True
+        self.unavailable_reason: Optional[str] = None
+        if not self._requests_available:  # pragma: no cover - optional dependency
+            self.is_available = False
+            self.unavailable_reason = (
+                "requests/bs4 fehlen. Installiere 'requests' und 'beautifulsoup4'."
+            )
+            if REQUESTS_IMPORT_ERROR:
+                print(f"DokuStreamsPlugin Importfehler: {REQUESTS_IMPORT_ERROR}")
+
+    async def search_titles(self, query: str) -> List[str]:
+        hits = self._search_hits(query)
+        self._title_to_url = {hit.title: hit.url for hit in hits if hit.title and hit.url}
+        for hit in hits:
+            if hit.title:
+                self._title_meta[hit.title] = (hit.plot, hit.poster)
+        titles = [hit.title for hit in hits if hit.title]
+        titles.sort(key=lambda value: value.casefold())
+        return titles
+
+    def _search_hits(self, query: str) -> List[SearchHit]:
+        query = (query or "").strip()
+        if not query or not self._requests_available:
+            return []
+        search_url = _absolute_url(f"/?s={quote(query)}")
+        session = get_requests_session("dokustreams", headers=HEADERS)
+        try:
+            soup = _get_soup(search_url, session=session)
+        except Exception:
+            return []
+        return _parse_listing_hits(soup, query=query)
+
+    def capabilities(self) -> set[str]:
+        return {"genres", "popular_series"}
+
+    def _categories_url(self) -> str:
+        return _absolute_url("/kategorien/")
+
+    def _parse_categories(self, soup: BeautifulSoupT) -> Dict[str, str]:
+        categories: Dict[str, str] = {}
+        if not soup:
+            return categories
+        root = soup.select_one("ul.nested-category-list")
+        if root is None:
+            return categories
+
+        def clean_name(value: str) -> str:
+            value = (value or "").strip()
+            return re.sub(r"\\s*\\(\\d+\\)\\s*$", "", value).strip()
+
+        def walk(ul, parents: List[str]) -> None:
+            for li in ul.find_all("li", recursive=False):
+                anchor = li.find("a", href=True)
+                if anchor is None:
+                    continue
+                name = clean_name(anchor.get_text(" ", strip=True) or "")
+                href = (anchor.get("href") or "").strip()
+                if not name or not href:
+                    continue
+                child_ul = li.find("ul", class_="nested-category-list")
+                if child_ul is not None:
+                    walk(child_ul, parents + [name])
+                else:
+                    if parents:
+                        label = " \u2192 ".join(parents + [name])
+                        categories[label] = _absolute_url(href)
+
+        walk(root, [])
+        return categories
+
+    def _parse_top_categories(self, soup: BeautifulSoupT) -> Dict[str, str]:
+        categories: Dict[str, str] = {}
+        if not soup:
+            return categories
+        root = soup.select_one("ul.nested-category-list")
+        if root is None:
+            return categories
+        for li in root.find_all("li", recursive=False):
+            anchor = li.find("a", href=True)
+            if anchor is None:
+                continue
+            name = (anchor.get_text(" ", strip=True) or "").strip()
+            href = (anchor.get("href") or "").strip()
+            if not name or not href:
+                continue
+            categories[name] = _absolute_url(href)
+        return categories
+
+    def genres(self) -> List[str]:
+        if not self._requests_available:
+            return []
+        if self._category_to_url:
+            return sorted(self._category_to_url.keys(), key=lambda value: value.casefold())
+        try:
+            soup = _get_soup(self._categories_url(), session=get_requests_session("dokustreams", headers=HEADERS))
+        except Exception:
+            return []
+        parsed = self._parse_categories(soup)
+        if parsed:
+            self._category_to_url = dict(parsed)
+        return sorted(self._category_to_url.keys(), key=lambda value: value.casefold())
+
+    def categories(self) -> List[str]:
+        if not self._requests_available:
+            return []
+        try:
+            soup = _get_soup(self._categories_url(), session=get_requests_session("dokustreams", headers=HEADERS))
+        except Exception:
+            return []
+        parsed = self._parse_top_categories(soup)
+        if parsed:
+            for key, value in parsed.items():
+                self._category_to_url.setdefault(key, value)
+        return list(parsed.keys())
+
+    def genre_page_count(self, genre: str) -> int:
+        genre = (genre or "").strip()
+        if not genre:
+            return 1
+        if genre in self._category_page_count_cache:
+            return max(1, int(self._category_page_count_cache.get(genre, 1)))
+        if not self._category_to_url:
+            self.genres()
+        base_url = self._category_to_url.get(genre, "")
+        if not base_url:
+            return 1
+        try:
+            soup = _get_soup(base_url, session=get_requests_session("dokustreams", headers=HEADERS))
+        except Exception:
+            return 1
+        pages = _extract_last_page(soup)
+        self._category_page_count_cache[genre] = max(1, pages)
+        return self._category_page_count_cache[genre]
+
+    def titles_for_genre_page(self, genre: str, page: int) -> List[str]:
+        genre = (genre or "").strip()
+        if not genre or not self._requests_available:
+            return []
+        if not self._category_to_url:
+            self.genres()
+        base_url = self._category_to_url.get(genre, "")
+        if not base_url:
+            return []
+        page = max(1, int(page or 1))
+        url = base_url if page == 1 else f"{base_url.rstrip('/')}/page/{page}/"
+        try:
+            soup = _get_soup(url, session=get_requests_session("dokustreams", headers=HEADERS))
+        except Exception:
+            return []
+        hits = _parse_listing_hits(soup)
+        for hit in hits:
+            if hit.title:
+                self._title_meta[hit.title] = (hit.plot, hit.poster)
+        titles = [hit.title for hit in hits if hit.title]
+        self._title_to_url.update({hit.title: hit.url for hit in hits if hit.title and hit.url})
+        return titles
+
+    def titles_for_genre(self, genre: str) -> List[str]:
+        titles = self.titles_for_genre_page(genre, 1)
+        titles.sort(key=lambda value: value.casefold())
+        return titles
+
+    def _most_viewed_url(self) -> str:
+        return _absolute_url(MOST_VIEWED_PATH)
+
+    def popular_series(self) -> List[str]:
+        if not self._requests_available:
+            return []
+        if self._popular_cache is not None:
+            titles = [hit.title for hit in self._popular_cache if hit.title]
+            titles.sort(key=lambda value: value.casefold())
+            return titles
+        try:
+            soup = _get_soup(self._most_viewed_url(), session=get_requests_session("dokustreams", headers=HEADERS))
+        except Exception:
+            return []
+        hits = _parse_listing_hits(soup)
+        self._popular_cache = list(hits)
+        self._title_to_url.update({hit.title: hit.url for hit in hits if hit.title and hit.url})
+        for hit in hits:
+            if hit.title:
+                self._title_meta[hit.title] = (hit.plot, hit.poster)
+        titles = [hit.title for hit in hits if hit.title]
+        titles.sort(key=lambda value: value.casefold())
+        return titles
+
+    def metadata_for(self, title: str) -> tuple[dict[str, str], dict[str, str], list[object] | None]:
+        title = (title or "").strip()
+        if not title:
+            return {}, {}, None
+        plot, poster = self._title_meta.get(title, ("", ""))
+        info: dict[str, str] = {"title": title}
+        if plot:
+            info["plot"] = plot
+        art: dict[str, str] = {}
+        if poster:
+            art = {"thumb": poster, "poster": poster}
+        return info, art, None
+
+    def seasons_for(self, title: str) -> List[str]:
+        title = (title or "").strip()
+        if not title or title not in self._title_to_url:
+            return []
+        return ["Stream"]
+
+    def episodes_for(self, title: str, season: str) -> List[str]:
+        title = (title or "").strip()
+        if not title or title not in self._title_to_url:
+            return []
+        return [title]
+
+    def stream_link_for(self, title: str, season: str, episode: str) -> Optional[str]:
+        title = (title or "").strip()
+        if not title:
+            return None
+        url = self._title_to_url.get(title)
+        if not url:
+            return None
+        if not self._requests_available:
+            return None
+        try:
+            soup = _get_soup(url, session=get_requests_session("dokustreams", headers=HEADERS))
+        except Exception:
+            return None
+        iframe = soup.select_one("div.fluid-width-video-wrapper iframe[src]")
+        if iframe is None:
+            iframe = soup.select_one("iframe[src*='youtube'], iframe[src*='vimeo'], iframe[src]")
+        if iframe is None:
+            return None
+        src = (iframe.get("src") or "").strip()
+        if not src:
+            return None
+        return _absolute_url(src)
+
+
+# Alias für die automatische Plugin-Erkennung.
+Plugin = DokuStreamsPlugin

addon/resources/settings.xml

@@ -45,6 +45,9 @@
   <category label="Filmpalast">
     <setting id="filmpalast_base_url" type="text" label="Domain (BASE_URL)" default="https://filmpalast.to" />
   </category>
+  <category label="Doku-Streams">
+    <setting id="doku_streams_base_url" type="text" label="Domain (BASE_URL)" default="https://doku-streams.com" />
+  </category>
   <category label="TMDB">
     <setting id="tmdb_enabled" type="bool" label="TMDB aktivieren" default="true" />
     <setting id="tmdb_api_key" type="text" label="TMDB API Key" default="" />
@@ -71,5 +74,6 @@
     <setting id="update_version_einschalten" type="text" label="Einschalten Plugin Version" default="-" enable="false" />
     <setting id="update_version_topstreamfilm" type="text" label="Topstreamfilm Plugin Version" default="-" enable="false" />
     <setting id="update_version_filmpalast" type="text" label="Filmpalast Plugin Version" default="-" enable="false" />
+    <setting id="update_version_doku_streams" type="text" label="Doku-Streams Plugin Version" default="-" enable="false" />
   </category>
 </settings>