fix(all): restore spotlight hero banner, fix detail poster overlap, enable reliable Home/Movies/TV navigation, and prevent STRM pruning playback errors

apex/repair_jellyfin_libraries.py

@@ -531,9 +531,15 @@ def heal_mismatched_media(roots=None, databases=None):
                                             conn.close()
                                         except Exception:
                                             pass
-                            elif f.endswith(".strm") or f.lower() in ("movie.nfo", "tvshow.nfo"):
+                            elif f.endswith(".strm"):
                                 try:
-                                    os.remove(src_f)
+                                    if not os.path.exists(dst_f):
+                                        shutil.copy2(src_f, dst_f)
+                                    elif not os.path.exists(src_f):
+                                        try:
+                                            os.link(dst_f, src_f)
+                                        except OSError:
+                                            shutil.copy2(dst_f, src_f)
                                 except Exception:
                                     pass
                         try:
@@ -558,8 +564,11 @@ def heal_mismatched_media(roots=None, databases=None):
                         new_strm = os.path.join(dirpath, f"{clean_strm_base}{ext}")
                         if not os.path.exists(new_strm):
                             try:
-                                os.rename(old_strm, new_strm)
-                                print(f"[REPAIR] Cleaned strm file: '{fn}' -> '{clean_strm_base}{ext}'")
+                                try:
+                                    os.link(old_strm, new_strm)
+                                except OSError:
+                                    shutil.copy2(old_strm, new_strm)
+                                print(f"[REPAIR] Created clean alias strm: '{fn}' -> '{clean_strm_base}{ext}'")
                                 for db_p in db_list:
                                     if os.path.exists(db_p):
                                         try:
@@ -570,7 +579,7 @@ def heal_mismatched_media(roots=None, databases=None):
                                         except Exception:
                                             pass
                             except Exception as strm_err:
-                                print(f"[REPAIR] Note renaming strm {old_strm}: {strm_err}")
+                                print(f"[REPAIR] Note creating strm alias {old_strm}: {strm_err}")
                 elif fn.lower() in ("movie.nfo", "tvshow.nfo"):
                     _heal_nfo_file(os.path.join(dirpath, fn))
 
@@ -784,6 +793,63 @@ def repair_system_xml(configs=None):
             print(f"[REPAIR] Note repairing {cfg}: {e}")
 
 
+
+def heal_missing_db_strm_paths(databases=None):
+    """Ensures every single .strm path recorded in Jellyfin BaseItems actually exists on disk.
+    If a file is missing due to prior pruning or dot/dash naming differences, reconstructs
+    or hardlinks it immediately from matching media on disk."""
+    db_list = databases or TARGET_DATABASES
+    for db_p in db_list:
+        if not os.path.exists(db_p):
+            continue
+        try:
+            conn = sqlite3.connect(db_p, timeout=10)
+            cur = conn.cursor()
+            cur.execute("SELECT Id, Path, Name FROM BaseItems WHERE Path LIKE '%.strm'")
+            rows = cur.fetchall()
+            repaired = 0
+            for row_id, path, name in rows:
+                if not path or os.path.exists(path):
+                    continue
+                parent_dir = os.path.dirname(path)
+                file_name = os.path.basename(path)
+                found_src = None
+
+                # 1. Search in the same parent directory for any .strm
+                if os.path.isdir(parent_dir):
+                    candidates = [os.path.join(parent_dir, f) for f in os.listdir(parent_dir) if f.lower().endswith(".strm")]
+                    if candidates:
+                        found_src = candidates[0]
+
+                # 2. If parent_dir doesn't exist, search grandparent directory for a matching folder
+                if not found_src:
+                    grandparent = os.path.dirname(parent_dir)
+                    parent_name = os.path.basename(parent_dir)
+                    if os.path.isdir(grandparent):
+                        norm_parent = re.sub(r"[^a-zA-Z0-9]", "", parent_name).lower()
+                        for sib in os.listdir(grandparent):
+                            sib_path = os.path.join(grandparent, sib)
+                            if os.path.isdir(sib_path):
+                                if re.sub(r"[^a-zA-Z0-9]", "", sib).lower() == norm_parent:
+                                    cands = [os.path.join(sib_path, f) for f in os.listdir(sib_path) if f.lower().endswith(".strm")]
+                                    if cands:
+                                        found_src = cands[0]
+                                        break
+
+                if found_src and os.path.exists(found_src):
+                    os.makedirs(parent_dir, exist_ok=True)
+                    try:
+                        os.link(found_src, path)
+                    except OSError:
+                        shutil.copy2(found_src, path)
+                    repaired += 1
+                    print(f"[REPAIR] Healed missing DB STRM: '{path}' <- '{found_src}'")
+            conn.close()
+            if repaired:
+                print(f"[REPAIR] Successfully healed {repaired} missing STRM file(s) for DB {db_p}")
+        except Exception as e:
+            print(f"[REPAIR] Note healing missing DB STRMs: {e}")
+
 def main():
     env_force = os.environ.get("RESET_JELLYFIN_PASSWORD", "").strip().lower() in ("1", "true", "yes")
     manual_trigger = any(os.path.exists(p) for p in MANUAL_RESET_TRIGGERS)
@@ -813,6 +879,7 @@ def main():
     heal_subtitle_files()
     heal_mismatched_media()
     heal_channel_and_db_names()
+    heal_missing_db_strm_paths()
     repair_user_subtitle_preferences()
     repair_user_policy_preferences()
     repair_system_xml()

apex/tg_streamer.py

@@ -5373,53 +5373,10 @@ async def subtitles_sync(request):
 
 
 async def _prune_orphan_strms(movies_dir, shows_dir, keep):
-    """Delete .strm files that point at our streamer but aren't in `keep`.
-
-    During a folder-layout migration Jellyfin indexes both the stale flat .strm
-    and the new per-title folder .strm for the same Telegram file -> duplicates.
-    Only files whose contents reference our own streamer are touched, so
-    unrelated .strm files are never removed.
-    """
-    removed = 0
-    for root_dir in (movies_dir, shows_dir):
-        if not os.path.isdir(root_dir):
-            continue
-        for root, _, files in os.walk(root_dir):
-            for f in files:
-                if not f.lower().endswith(".strm"):
-                    continue
-                path = os.path.normpath(os.path.join(root, f))
-                if path in keep:
-                    continue
-                try:
-                    with open(path, "r", encoding="utf-8", errors="ignore") as fh:
-                        content = fh.read(256)
-                except OSError:
-                    continue
-                stream_port = os.environ.get(
-                    "TG_LISTEN_PORT", os.environ.get("PORT", "8080")
-                )
-                is_our_stream = (
-                    "/stream/" in content
-                    or f"127.0.0.1:{stream_port}" in content
-                    or f":{stream_port}/" in content
-                )
-                if not is_our_stream:
-                    continue
-                try:
-                    os.remove(path)
-                    removed += 1
-                    logger.info(f"[RESTORE] Pruned orphaned .strm: {path}")
-                    parent_dir = os.path.dirname(path)
-                    if os.path.isdir(parent_dir) and not os.listdir(parent_dir):
-                        try:
-                            os.rmdir(parent_dir)
-                            logger.info(f"[RESTORE] Cleaned empty parent folder: {parent_dir}")
-                        except OSError:
-                            pass
-                except OSError as e:
-                    logger.warning(f"[RESTORE] Could not prune {path}: {e}")
-    return removed
+    """Safely preserve all .strm files. Deletion is permanently disabled to ensure
+    seamless media playback across all library naming variants."""
+    logger.info("[RESTORE] Automatic .strm pruning is safely disabled to safeguard media playback.")
+    return 0
 
 
 async def restore_cached_strm_files():

apex/ui/abyss.css

@@ -4306,8 +4306,8 @@ div[data-category="nextup"] .cardScalable,
     align-items: center !important;
     padding-left: 16px !important;
     padding-right: 16px !important;
-    z-index: 10001 !important;
-    pointer-events: none !important;
+    z-index: 99999 !important;
+    pointer-events: auto !important;
 }
 
 #apex-tv-topbar .apex-tv-tabs {
@@ -4387,12 +4387,9 @@ div[data-category="nextup"] .cardScalable,
     }
 }
 
-/* Hide topbar when video player or settings are active */
-body:has(#videoOsdPage:not(.hide)) #apex-tv-topbar,
-body:has(.videoOsd:not(.hide)) #apex-tv-topbar,
-body:has(.nowPlayingPage:not(.hide)) #apex-tv-topbar,
-body:has(#dashboardPage:not(.hide)) #apex-tv-topbar,
-body.jellyfin-settings-page #apex-tv-topbar {
+/* Hide topbar only during active fullscreen video playback or settings */
+body.videoPlayerContainerVisible #apex-tv-topbar,
+body.hide-apex-topbar #apex-tv-topbar {
     display: none !important;
     opacity: 0 !important;
     pointer-events: none !important;
@@ -4453,3 +4450,114 @@ body.jellyfin-settings-page #apex-tv-topbar {
         box-sizing: border-box !important;
     }
 }
+
+
+/* ========================================================
+   DETAIL PAGE: POSTER THUMBNAIL & METADATA SPACING FIX
+   Prevents poster from overlapping title/metadata text
+   ======================================================== */
+#itemDetailPage .detailRibbon,
+.layout-mobile #itemDetailPage .detailRibbon,
+.layout-desktop #itemDetailPage .detailRibbon,
+.layout-tv #itemDetailPage .detailRibbon,
+.detailRibbon {
+    display: flex !important;
+    flex-direction: row !important;
+    align-items: flex-start !important;
+    gap: 18px !important;
+    padding-left: 16px !important;
+    padding-right: 16px !important;
+    margin-top: 0 !important;
+    box-sizing: border-box !important;
+}
+
+#itemDetailPage .detailImageContainer,
+.detailImageContainer {
+    position: relative !important;
+    flex-shrink: 0 !important;
+    width: 140px !important;
+    max-width: 140px !important;
+    margin: 0 !important;
+    z-index: 2 !important;
+}
+
+#itemDetailPage .detailImageContainer .card,
+.layout-mobile #itemDetailPage .detailImageContainer .card,
+.layout-desktop #itemDetailPage .detailImageContainer .card,
+.layout-tv #itemDetailPage .detailImageContainer .card,
+.detailImageContainer .card {
+    position: relative !important;
+    top: auto !important;
+    left: auto !important;
+    margin: 0 !important;
+    width: 140px !important;
+    max-width: 140px !important;
+    border-radius: 12px !important;
+}
+
+#itemDetailPage .detailPagePrimaryContent,
+.layout-mobile #itemDetailPage .detailPagePrimaryContent,
+.layout-desktop #itemDetailPage .detailPagePrimaryContent,
+.layout-tv #itemDetailPage .detailPagePrimaryContent,
+.detailPagePrimaryContent {
+    flex: 1 1 auto !important;
+    min-width: 0 !important;
+    padding-left: 0 !important;
+    margin-left: 0 !important;
+}
+
+#itemDetailPage .itemName,
+.itemName {
+    word-break: break-word !important;
+    overflow-wrap: break-word !important;
+}
+
+/* Universal Abyss Spotlight Hero Banner Iframe */
+iframe.featurediframe {
+    width: 100% !important;
+    display: block !important;
+    border: none !important;
+    margin: 0 !important;
+    padding: 0 !important;
+    min-height: 380px !important;
+    height: 52vh !important;
+    opacity: 1 !important;
+    visibility: visible !important;
+}
+
+@media (orientation: landscape) {
+    iframe.featurediframe {
+        height: 70vh !important;
+        min-height: 340px !important;
+    }
+}
+
+/* Suppress Cast, SyncPlay, Menu/Hamburger buttons */
+button[aria-label="Menu"],
+button[aria-label="menu"],
+button:has(svg[data-testid="MenuIcon"]),
+.claude-stepped-menu,
+.mainDrawerButton,
+.headerButtonMenu,
+.headerSyncplayButton,
+.btnSyncPlay,
+.headerCastButton,
+.btnCast,
+button[data-action="cast"],
+button[data-action="syncplay"],
+button[title*="SyncPlay" i],
+button[aria-label*="SyncPlay" i],
+button[title*="Cast" i],
+button[aria-label*="Cast" i],
+button:has(svg[data-testid="CastIcon"]),
+button:has(svg[data-testid="GroupIcon"]),
+button:has(svg[data-testid="PeopleIcon"]),
+.headerLeft,
+.headerTabs.sectionTabs {
+    display: none !important;
+    visibility: hidden !important;
+    pointer-events: none !important;
+    width: 0 !important;
+    height: 0 !important;
+    opacity: 0 !important;
+}

apex/ui/spotlight-loader.js

@@ -262,12 +262,16 @@
   });
 
   function isRouteVisible(indexPage, homeTab) {
-    if (!indexPage || !indexPage.isConnected || !homeTab || !homeTab.isConnected) return false;
+    if (!homeTab || !homeTab.isConnected) return false;
     if (document.hidden) return false;
-    if (indexPage.classList.contains("hide") || indexPage.hidden) return false;
-    var style = window.getComputedStyle(homeTab);
-    if (style.display === "none") return false;
-    return homeTab.offsetParent !== null || homeTab.getClientRects().length > 0 || !homeTab.classList.contains("hide");
+    var hash = window.location.hash || "";
+    if (hash && hash !== "#/" && hash !== "#" && hash.indexOf("/home") === -1) {
+      if (hash.indexOf("details") !== -1 || hash.indexOf("search") !== -1 || hash.indexOf("settings") !== -1 || hash.indexOf("dashboard") !== -1 || hash.indexOf("video") !== -1) {
+        return false;
+      }
+    }
+    if (indexPage && (indexPage.classList.contains("hide") || indexPage.hidden)) return false;
+    return true;
   }
 
   function connectLifecycle(indexPage, homeTab, favoritesTab, iframe) {
@@ -328,60 +332,78 @@
 
   var currentSync = null;
 
-  function findVisibleById(id) {
-    var candidates = document.querySelectorAll('[id="' + id + '"]');
-    for (var i = 0; i < candidates.length; i++) {
-      var el = candidates[i];
-      if (
-        el.isConnected &&
-        !el.classList.contains("hide") &&
-        !el.hidden
-      ) {
-        return el;
-      }
+  function findHomeTab() {
+    var homeTab = document.querySelector("#homeTab");
+    if (homeTab && homeTab.isConnected) return homeTab;
+
+    var indexPage = document.querySelector("#indexPage");
+    if (indexPage && indexPage.isConnected) {
+      var tab = indexPage.querySelector("#homeTab, .pageTabContent.is-active, .tabContent.is-active");
+      if (tab) return tab;
+      var sec = indexPage.querySelector(".sections, .homeSectionsContainer");
+      if (sec && sec.parentElement) return sec.parentElement;
+      return indexPage;
     }
-    return candidates.length ? candidates[candidates.length - 1] : null;
+
+    var activeTab = document.querySelector(".pageTabContent.is-active, div[data-role='page']:not(.hide) .homeSectionsContainer");
+    if (activeTab) return activeTab.closest(".pageTabContent, div[data-role='page']") || activeTab;
+
+    return null;
   }
 
   function installSpotlight() {
     var installed = false;
     safe(function () {
-      var indexPage = findVisibleById("indexPage");
-      if (!indexPage) {
+      var hash = window.location.hash || "";
+      if (hash.indexOf("dashboard") !== -1 || hash.indexOf("settings") !== -1 || hash.indexOf("video") !== -1) {
         clearSpotlightLifecycle();
         return;
       }
-      var homeTab = indexPage.querySelector("#homeTab");
+
+      var homeTab = findHomeTab();
       if (!homeTab) {
-        clearSpotlightLifecycle();
         return;
       }
-      var favoritesTab = indexPage.querySelector("#favoritesTab");
+
+      var indexPage = homeTab.closest("#indexPage, div[data-role='page'], .page") || homeTab;
+      var favoritesTab = document.querySelector("#favoritesTab");
 
       installFrameStyle();
       installBackdropOverlay();
 
       var iframe = homeTab.querySelector ? homeTab.querySelector("." + FRAME_CLASS) : null;
+      if (!iframe) {
+        iframe = document.querySelector("." + FRAME_CLASS);
+      }
+
       if (!iframe) {
         iframe = document.createElement("iframe");
         iframe.className = FRAME_CLASS + " focusable";
         iframe.setAttribute("tabindex", "0");
         iframe.src = spotlightUrl;
         iframe.title = "Abyss Spotlight";
+        iframe.style.width = "100%";
+        iframe.style.display = "block";
+        iframe.style.border = "none";
         iframe.addEventListener("blur", function () { spotlightFocused = false; });
-        var sections = homeTab.querySelector ? homeTab.querySelector(".sections") : null;
+        var sections = homeTab.querySelector ? homeTab.querySelector(".sections, .homeSectionsContainer") : null;
+        homeTab.insertBefore(iframe, sections || homeTab.firstChild);
+      } else if (iframe.parentElement !== homeTab) {
+        var sections = homeTab.querySelector ? homeTab.querySelector(".sections, .homeSectionsContainer") : null;
         homeTab.insertBefore(iframe, sections || homeTab.firstChild);
       }
 
-      safe(function () {
-        if (indexPage.classList) indexPage.classList.add("abyss-spotlight-active");
-        if (homeTab.classList) homeTab.classList.add("abyss-spotlight-active");
-      });
+      iframe.style.display = "block";
+      iframe.style.visibility = "visible";
+      iframe.style.opacity = "1";
+      document.documentElement.classList.add("abyss-spotlight-visible");
+
+      if (indexPage && indexPage.classList) indexPage.classList.add("abyss-spotlight-active");
+      if (homeTab.classList) homeTab.classList.add("abyss-spotlight-active");
 
       if (
         indexPage !== currentIndexPage ||
         homeTab !== currentHomeTab ||
-        favoritesTab !== currentFavoritesTab ||
         iframe !== currentIframe
       ) {
         currentIndexPage = indexPage;
@@ -445,7 +467,7 @@
       var logoSvgUrl = (window.location.pathname.indexOf("/web") !== -1) ? "ui/apex-logo.svg" : "/jellyfin/web/ui/apex-logo.svg";
 
       // 1. Favicon sync
-      var links = document.querySelectorAll("link[rel*='icon']");
+      var links = document.querySelectorAll("a[href*=\x22" + targetId + "\x22], [data-id=\x22" + targetId + "\x22]");
       for (var i = 0; i < links.length; i++) {
         if (links[i].getAttribute("data-apex-logo") !== "true") {
           links[i].setAttribute("data-apex-logo", "true");
@@ -597,7 +619,7 @@
     }, 400);
   }
 
-  var libIds = { movies: null, tvshows: null };
+  var libIds = { movies: "f137a2dd21bbc1b99aa5c0f6bf02a805", tvshows: "767bffe4f11c93ef34b805451a696a4e" };
   var librariesDiscovered = false;
 
   function discoverLibraries() {
@@ -635,53 +657,27 @@
       return;
     }
 
-    if (name === "Movies") {
-      var cards = document.querySelectorAll('.card[data-type="CollectionFolder"], [data-category="views"] .card');
-      for (var i = 0; i < cards.length; i++) {
-        if ((cards[i].textContent || "").toLowerCase().indexOf("movie") !== -1) {
-          cards[i].click();
-          return;
-        }
-      }
-      if (libIds.movies) {
-        var url = "/details?id=" + libIds.movies;
-        if (window.Emby && window.Emby.Page && typeof window.Emby.Page.show === "function") {
-          window.Emby.Page.show(url);
-          return;
-        }
-        window.location.hash = "#" + url;
+    var targetId = name === "Movies" ? libIds.movies : libIds.tvshows;
+    if (targetId) {
+      var links = document.querySelectorAll("a[href*=\x22" + targetId + "\x22], [data-id=\x22" + targetId + "\x22]");
+      if (links.length && links[0].click) {
+        links[0].click();
         return;
       }
-      window.location.hash = "#/movies";
-      return;
-    }
-
-    if (name === "TV Shows") {
-      var tvCards = document.querySelectorAll('.card[data-type="CollectionFolder"], [data-category="views"] .card');
-      for (var t = 0; t < tvCards.length; t++) {
-        var text = (tvCards[t].textContent || "").toLowerCase();
-        if (text.indexOf("tv") !== -1 || text.indexOf("show") !== -1 || text.indexOf("series") !== -1) {
-          tvCards[t].click();
-          return;
-        }
-      }
-      if (libIds.tvshows) {
-        var url = "/details?id=" + libIds.tvshows;
-        if (window.Emby && window.Emby.Page && typeof window.Emby.Page.show === "function") {
-          window.Emby.Page.show(url);
-          return;
-        }
-        window.location.hash = "#" + url;
+      var targetUrl = "/details?id=" + targetId;
+      if (window.Emby && window.Emby.Page && typeof window.Emby.Page.show === "function") {
+        window.Emby.Page.show(targetUrl);
         return;
       }
-      window.location.hash = "#/shows";
+      window.location.hash = "#" + targetUrl;
       return;
     }
+    window.location.hash = name === "Movies" ? "#/movies" : "#/shows";
   }
 
   function updateActiveNavTab() {
     var hash = window.location.hash || "";
-    var links = document.querySelectorAll(".apex-tv-tab, .apex-nav-item");
+      var links = document.querySelectorAll("a[href*=\x22" + targetId + "\x22], [data-id=\x22" + targetId + "\x22]");
     for (var i = 0; i < links.length; i++) {
       var item = links[i];
       var navType = item.getAttribute("data-nav");
@@ -751,6 +747,17 @@
         document.body.appendChild(tvTopbar);
       }
 
+      if (tvTopbar) {
+        var isVideo = !!document.querySelector(".videoPlayerContainer:not(.hide), #videoOsdPage:not(.hide), video");
+        var hash = window.location.hash || "";
+        var isHiddenRoute = hash.indexOf("dashboard") !== -1 || hash.indexOf("settings") !== -1;
+        if (isVideo || isHiddenRoute) {
+          tvTopbar.style.display = "none";
+        } else {
+          tvTopbar.style.display = "flex";
+        }
+      }
+
       // 2. Hide Hamburger, Cast, SyncPlay, and stray drawer buttons completely
       var unwanted = document.querySelectorAll(
         'button[aria-label="Menu"], button[aria-label="menu"], ' +