Update manifest.json for release v1.6.3.0 [skip ci]

Jellyfin.Plugin.MediaBarEnhanced/Configuration/PluginConfiguration.cs

@@ -22,6 +22,9 @@ namespace Jellyfin.Plugin.MediaBarEnhanced.Configuration
         public bool EnableVideoBackdrop { get; set; } = true;
         public bool UseSponsorBlock { get; set; } = true;
         public bool PreferLocalTrailers { get; set; } = false;
+        public bool RandomizeLocalTrailers { get; set; } = false;
+        public bool PreferLocalBackdrops { get; set; } = false;
+        public bool RandomizeThemeVideos { get; set; } = false;
         public bool WaitForTrailerToEnd { get; set; } = true;
         public bool StartMuted { get; set; } = true;
         public bool FullWidthVideo { get; set; } = true;
@@ -38,6 +41,7 @@ namespace Jellyfin.Plugin.MediaBarEnhanced.Configuration
         public bool IsEnabled { get; set; } = true;
         public bool EnableClientSideSettings { get; set; } = false;
         public bool ApplyLimitsToCustomIds { get; set; } = false;
+        public bool IncludeWatchedContent { get; set; } = false;
         public string SortBy { get; set; } = "Random";
         public string SortOrder { get; set; } = "Ascending";
     }

Jellyfin.Plugin.MediaBarEnhanced/Configuration/configPage.html

@@ -65,6 +65,14 @@
                             </label>
                             <div class="fieldDescription">If enabled, local trailers will be preferred over remote (YouTube) trailers.</div>
                         </div>
+                        <div class="checkboxContainer checkboxContainer-withDescription" id="PreferLocalBackdropsContainer">
+                            <label>
+                                <input is="emby-checkbox" type="checkbox" id="PreferLocalBackdrops"
+                                    name="PreferLocalBackdrops" />
+                                <span>Prefer Local Backdrops / Theme Videos</span>
+                            </label>
+                            <div class="fieldDescription">If enabled, local backdrop videos (Theme Videos) will be preferred over trailers.</div>
+                        </div>
                         <div class="checkboxContainer checkboxContainer-withDescription">
                             <label>
                                 <input is="emby-checkbox" type="checkbox" id="WaitForTrailerToEnd"
@@ -115,14 +123,10 @@
                         </div>
                         <div id="customMediaIdsContainer">
                             <div class="inputContainer">
-                                <label class="inputLabel inputLabelUnfocused" for="CustomMediaIds">Default Media/Collection/Playlist
+                                <label class="inputLabel inputLabelUnfocused" for="CustomMediaIds">Default Media/Collection/Playlist IDs (Newline or Comma-separated)</label>
-                                    IDs
-                                    (Newline or Comma separated)</label>
                                 <textarea class="emby-textarea" is="emby-textarea" id="CustomMediaIds" name="CustomMediaIds"
                                     style="width: 100%; height: 150px; font-family: monospace;"></textarea>
-                                <div class="fieldDescription">Enter the IDs of the items you want to show in the slideshow as
+                                <div class="fieldDescription">Enter the IDs of the items you want to show in the slideshow as your default content. You can separate them by new line or comma.
-                                    your default content.
-                                    You can separate them by new line or comma.
                                     <br><br>
                                     <b>Manual Trailer/Video Override:</b> You can specify a YouTube URL <b>OR</b> a Jellyfin Item ID (e.g. for a Theme Video) for an item by adding it in
                                     brackets: <br> <code>e.g. ID DESCRIPTION [https://youtu.be/...]</code> or <code>ID [JellyfinItemId] DESCRIPTION</code>.
@@ -132,11 +136,9 @@
                                         <li><b>YouTube URL:</b> Play a remote trailer from YouTube.</li>
                                         <li><b>Jellyfin Item ID (GUID):</b> Play the video of another library item (e.g. a Theme Video or Backdrop Video) using the native player.</li>
                                     </ul>
-                                    You can also add a description after the ID using any separator like space, pipe
+                                    You can also add a description after the ID using any separator like space, pipe (|) or dash (-): <br>e.g. <code>ID DESCRIPTION</code> or <code>ID | DESCRIPTION</code>
-                                    (|) or dash (-): <br>e.g. <code>ID DESCRIPTION</code> or <code>ID | DESCRIPTION</code>
                                     <br><br>
-                                    <b>Note:</b> If using a <b>Collection Name</b> (instead of an ID) combined with a description, you <b>MUST</b> use 
+                                    <b>Note:</b> If using a <b>Collection Name</b> (instead of an ID) combined with a description, you <b>MUST</b> use the pipe (|) separator.
-                                    the pipe (|) separator.
                                     <br>
                                     <b>Note:</b> The separator <b>MUST NOT</b> be a hex character (0-9, a-f).
                                 </div>
@@ -158,8 +160,8 @@
                                     name="EnableSeasonalContent" />
                                 <span>Enable Seasonal Content</span>
                             </label>
-                            <div class="fieldDescription">When enabled, seasonal sections below will override the default list
+                            <div class="fieldDescription">When enabled, seasonal sections below will override the default list or random selection
-                                during their active date ranges. If no season matches the current date, the default Custom Media IDs above are used as fallback.</div>
+                                during their active date ranges. If no season matches the current date, the default Custom Media IDs above or random selection are used as fallback.</div>
                         </div>
                         <div id="seasonalContentContainer" style="display: none;">
                             <div id="seasonalSectionsList"></div>
@@ -193,12 +195,28 @@
                             <div class="fieldDescription">If enabled, users will see a media bar icon in the header to
                                 override settings (like disabling the bar or trailer backdrops) locally on their device.</div>
                         </div>
+                        <div class="checkboxContainer checkboxContainer-withDescription">
+                            <label>
+                                <input is="emby-checkbox" type="checkbox" id="RandomizeThemeVideos"
+                                    name="RandomizeThemeVideos" />
+                                <span>Randomize Backdrop Video</span>
+                            </label>
+                            <div class="fieldDescription">If enabled, a random video from the backdrops/theme videos will be selected instead of the first one (if multiple exist).</div>
+                        </div>
+                        <div class="checkboxContainer checkboxContainer-withDescription">
+                            <label>
+                                <input is="emby-checkbox" type="checkbox" id="RandomizeLocalTrailers"
+                                    name="RandomizeLocalTrailers" />
+                                <span>Randomize Local Trailer</span>
+                            </label>
+                            <div class="fieldDescription">If enabled, a random local trailer will be selected instead of the first one (if multiple exist).</div>
+                        </div>
                         <div class="checkboxContainer checkboxContainer-withDescription">
                             <label>
                                 <input is="emby-checkbox" type="checkbox" id="UseSponsorBlock" name="UseSponsorBlock" />
                                 <span>Use SponsorBlock</span>
                             </label>
-                            <div class="fieldDescription">Skip intro/outro segments in YouTube trailers.</div>
+                            <div class="fieldDescription">Skip intro/outro segments in YouTube trailers (if data is available).</div>
                         </div>
                         <div class="selectContainer">
                             <label class="selectLabel" for="PreferredVideoQuality">Preferred YouTube Quality</label>
@@ -367,6 +385,14 @@
                             <input is="emby-input" type="number" id="MaxPlotLength" name="MaxPlotLength" />
                             <div class="fieldDescription">Maximum characters for the plot summary.</div>
                         </div>
+                        <div class="checkboxContainer checkboxContainer-withDescription">
+                            <label>
+                                <input is="emby-checkbox" type="checkbox" id="IncludeWatchedContent"
+                                    name="IncludeWatchedContent" />
+                                <span>Include Watched Content</span>
+                            </label>
+                            <div class="fieldDescription">If enabled, watched content will be included in the random selection results.</div>
+                        </div>
                     </div>
 
                     <div
@@ -425,7 +451,9 @@
                             'ShowTrailerButton', 'AlwaysShowArrows', 'EnableKeyboardControls',
                             'EnableCustomMediaIds', 'CustomMediaIds', 'EnableLoadingScreen',
                             'EnableSeasonalContent', 'EnableClientSideSettings', 'SortBy', 'SortOrder',
-                            'PreferLocalTrailers', 'ApplyLimitsToCustomIds', 'SeasonalSections'
+                            'PreferLocalTrailers', 'ApplyLimitsToCustomIds', 'SeasonalSections',
+                            'PreferLocalBackdrops', 'RandomizeThemeVideos', 'RandomizeLocalTrailers',
+                            'IncludeWatchedContent'
                         ];
 
                         keys.forEach(function (key) {
@@ -476,12 +504,15 @@
                         // Handle Prefer Local Trailers visibility
                         var enableVideoBackdropCheckbox = page.querySelector('#EnableVideoBackdrop');
                         var preferLocalContainer = page.querySelector('#PreferLocalTrailersContainer');
+                        var preferLocalBackdropsContainer = page.querySelector('#PreferLocalBackdropsContainer');
 
                         function updatePreferLocalVisibility() {
                             if (enableVideoBackdropCheckbox && enableVideoBackdropCheckbox.checked) {
                                 if (preferLocalContainer) preferLocalContainer.style.display = 'block';
+                                if (preferLocalBackdropsContainer) preferLocalBackdropsContainer.style.display = 'block';
                             } else {
                                 if (preferLocalContainer) preferLocalContainer.style.display = 'none';
+                                if (preferLocalBackdropsContainer) preferLocalBackdropsContainer.style.display = 'none';
                             }
                         }
 
@@ -511,7 +542,9 @@
                         'ShowTrailerButton', 'AlwaysShowArrows', 'EnableKeyboardControls',
                         'EnableCustomMediaIds', 'CustomMediaIds', 'EnableLoadingScreen',
                         'EnableSeasonalContent', 'EnableClientSideSettings', 'SortBy', 'SortOrder',
-                        'PreferLocalTrailers', 'ApplyLimitsToCustomIds', 'SeasonalSections'
+                        'PreferLocalTrailers', 'ApplyLimitsToCustomIds', 'SeasonalSections',
+                        'PreferLocalBackdrops', 'RandomizeThemeVideos', 'RandomizeLocalTrailers',
+                        'IncludeWatchedContent'
                     ];
 
                     keys.forEach(function (key) {
@@ -603,7 +636,7 @@
                         '<div class="inputContainer">' +
                         '    <label class="inputLabel" style="margin-bottom:0.5em; display:block;">Media IDs</label>' +
                         '    <textarea is="emby-textarea" class="emby-textarea section-ids" style="width: 100%; height: 80px; font-family: monospace;">' + (data.MediaIds || '') + '</textarea>' +
-                        '    <div class="fieldDescription">Comma-separated list of Movie/Series/Collection IDs to show during this season.</div>' +
+                        '    <div class="fieldDescription">Comma-separated or Newline separated list of Movie/Series/Collection IDs to show during this season.<br>Same options available as for the default media IDs.</div>' +
                         '</div>';
 
                     div.querySelector('.remove-section').addEventListener('click', function() {

Jellyfin.Plugin.MediaBarEnhanced/Jellyfin.Plugin.MediaBarEnhanced.csproj

@@ -12,7 +12,7 @@
     <!-- <TreatWarningsAsErrors>false</TreatWarningsAsErrors> -->
     <Title>Jellyfin Media Bar Enhanced Plugin</Title>
     <Authors>CodeDevMLH</Authors>
-    <Version>1.6.1.17</Version>
+    <Version>1.6.3.0</Version>
     <RepositoryUrl>https://github.com/CodeDevMLH/jellyfin-plugin-media-bar-enhanced</RepositoryUrl>
   </PropertyGroup>
 

Jellyfin.Plugin.MediaBarEnhanced/ScriptInjector.cs

@@ -18,8 +18,8 @@ namespace Jellyfin.Plugin.MediaBarEnhanced
     {
         private readonly IApplicationPaths _appPaths;
         private readonly ILogger<ScriptInjector> _logger;
-        public const string ScriptTag = "<script src=\"/MediaBarEnhanced/Resources/mediaBarEnhanced.js\" defer></script>";
+        public const string ScriptTag = "<script src=\"../MediaBarEnhanced/Resources/mediaBarEnhanced.js\" defer></script>";
-        public const string CssTag = "<link rel=\"stylesheet\" href=\"/MediaBarEnhanced/Resources/mediaBarEnhanced.css\" />";
+        public const string CssTag = "<link rel=\"stylesheet\" href=\"../MediaBarEnhanced/Resources/mediaBarEnhanced.css\" />";
         public const string ScriptMarker = "</body>";
         public const string CssMarker = "</head>";
 

Jellyfin.Plugin.MediaBarEnhanced/Web/mediaBarEnhanced.js

@@ -42,6 +42,10 @@ const CONFIG = {
   enableVideoBackdrop: true,
   useSponsorBlock: true,
   preferLocalTrailers: false,
+  randomizeLocalTrailers: false,
+  preferLocalBackdrops: false,
+  randomizeThemeVideos: false,
+  includeWatchedContent: false,
   waitForTrailerToEnd: true,
   startMuted: true,
   fullWidthVideo: true,
@@ -433,7 +437,7 @@ const waitForApiClientAndInitialize = () => {
 
 const fetchPluginConfig = async () => {
   try {
-    const response = await fetch('/MediaBarEnhanced/Config');
+    const response = await fetch('../MediaBarEnhanced/Config');
     if (response.ok) {
       const pluginConfig = await response.json();
       if (pluginConfig) {
@@ -1118,8 +1122,11 @@ const ApiUtils = {
         sortParams += `&sortOrder=${CONFIG.sortOrder}`;
       }
 
+      // Filter by isPlayed=False unless IncludeWatchedContent is enabled
+      const playedFilter = CONFIG.includeWatchedContent ? '' : '&isPlayed=False';
+
       const response = await fetch(
-        `${STATE.jellyfinData.serverAddress}/Items?IncludeItemTypes=Movie,Series&Recursive=true&hasOverview=true&imageTypes=Logo,Backdrop&${sortParams}&isPlayed=False&enableUserData=true&Limit=${CONFIG.maxItems}&fields=Id`,
+        `${STATE.jellyfinData.serverAddress}/Items?IncludeItemTypes=Movie,Series&Recursive=true&hasOverview=true&imageTypes=Logo,Backdrop&${sortParams}${playedFilter}&enableUserData=true&Limit=${CONFIG.maxItems}&fields=Id`,
         {
           headers: this.getAuthHeaders(),
         }
@@ -1258,9 +1265,20 @@ const ApiUtils = {
    */
   async fetchSponsorBlockData(videoId) {
     if (!CONFIG.useSponsorBlock) return { intro: null, outro: null };
+
+    // Return cached result if available
+    if (!this._sponsorBlockCache) this._sponsorBlockCache = {};
+    if (this._sponsorBlockCache[videoId]) {
+      return this._sponsorBlockCache[videoId];
+    }
+
     try {
       const response = await fetch(`https://sponsor.ajay.app/api/skipSegments?videoID=${videoId}&categories=["intro","outro"]`);
-      if (!response.ok) return { intro: null, outro: null };
+      if (!response.ok) {
+        const result = { intro: null, outro: null };
+        this._sponsorBlockCache[videoId] = result;
+        return result;
+      }
 
       const segments = await response.json();
       let intro = null;
@@ -1274,7 +1292,9 @@ const ApiUtils = {
         }
       });
 
-      return { intro, outro };
+      const result = { intro, outro };
+      this._sponsorBlockCache[videoId] = result;
+      return result;
     } catch (error) {
       console.warn('Error fetching SponsorBlock data:', error);
       return { intro: null, outro: null };
@@ -1360,13 +1380,21 @@ const ApiUtils = {
 
         const trailers = await response.json();
         if (trailers && trailers.length > 0) {
-        const trailer = trailers[0];
+            
+            let trailer;
+            if (CONFIG.randomizeLocalTrailers && trailers.length > 1) {
+                const randomIndex = Math.floor(Math.random() * trailers.length);
+                trailer = trailers[randomIndex];
+                 console.log(`Using random local trailer (${randomIndex + 1}/${trailers.length}) for ${itemId}: ${trailer.Name}`);
+            } else {
+                trailer = trailers[0];
+            }
+
             const mediaSourceId = trailer.MediaSources && trailer.MediaSources[0] ? trailer.MediaSources[0].Id : trailer.Id;
 
-        // Return object with ID and URL
             return {
                 id: trailer.Id,
-            url: `${STATE.jellyfinData.serverAddress}/Videos/${trailer.Id}/stream.mp4?Static=true&mediaSourceId=${mediaSourceId}&api_key=${STATE.jellyfinData.accessToken}`
+                url: `${STATE.jellyfinData.serverAddress}/Videos/${trailer.Id}/stream.mp4?mediaSourceId=${mediaSourceId}&api_key=${STATE.jellyfinData.accessToken}`
             };
         }
         return null;
@@ -1374,6 +1402,46 @@ const ApiUtils = {
       console.error(`Error fetching local trailer for ${itemId}:`, error);
       return null;
     }
+  },
+
+  /**
+   * Fetches theme videos for an item
+   * @param {string} itemId - Item ID
+   * @returns {Promise<Object|null>} Theme video data object {id, url} or null
+   */
+  async fetchThemeVideos(itemId) {
+    try {
+      const response = await fetch(
+          `${STATE.jellyfinData.serverAddress}/Items/${itemId}/ThemeVideos?userId=${STATE.jellyfinData.userId}`, 
+          { headers: this.getAuthHeaders() }
+      );
+      
+      if (response.ok) {
+           const data = await response.json();
+           const items = Array.isArray(data) ? data : (data.Items || []);
+           
+           if (items.length > 0) {
+               let video;
+               if (CONFIG.randomizeThemeVideos && items.length > 1) {
+                   const randomIndex = Math.floor(Math.random() * items.length);
+                   video = items[randomIndex];
+                   console.log(`Found Theme Video (Random ${randomIndex + 1}/${items.length}) via ThemeVideos endpoint: ${video.Name} (${video.Id})`);
+               } else {
+                   video = items[0];
+                   console.log(`Found Theme Video (First) via ThemeVideos endpoint: ${video.Name} (${video.Id})`);
+               }
+
+               return {
+                   id: video.Id,
+                   url: `${STATE.jellyfinData.serverAddress}/Videos/${video.Id}/stream.mp4?api_key=${STATE.jellyfinData.accessToken}`
+               };
+           }
+      }
+      return null;
+    } catch (error) {
+      console.error(`Error fetching theme videos for ${itemId}:`, error);
+      return null;
+    }
   }
 };
 
@@ -1435,8 +1503,6 @@ const VisibilityObserver = {
     
     // If a full screen video player is active, hide slideshow and stop playback
     if ((videoPlayer && !videoPlayer.classList.contains('hide')) || (trailerPlayer && !trailerPlayer.classList.contains('hide'))) {
-        if (this._lastVisibleState !== 'player-active') {
-            this._lastVisibleState = 'player-active';
         const container = document.getElementById("slides-container");
         if (container) {
             container.style.display = "none";
@@ -1447,7 +1513,6 @@ const VisibilityObserver = {
             STATE.slideshow.slideInterval.stop();
         }
         SlideshowManager.stopAllPlayback();
-        }
         return;
     }
 
@@ -1462,12 +1527,6 @@ const VisibilityObserver = {
       activeTab &&
       activeTab.getAttribute("data-index") === "0";
 
-    const newState = isVisible ? 'visible' : 'hidden';
-    
-    // Only update DOM and trigger actions when state actually changes
-    if (this._lastVisibleState !== newState) {
-      this._lastVisibleState = newState;
-      
     container.style.display = isVisible ? "block" : "none";
     container.style.visibility = isVisible ? "visible" : "hidden";
     container.style.pointerEvents = isVisible ? "auto" : "none";
@@ -1483,20 +1542,13 @@ const VisibilityObserver = {
       }
       SlideshowManager.stopAllPlayback();
     }
-    }
   },
 
   /**
    * Initializes visibility observer
    */
   init() {
-    // MARK: Mark
     const observer = new MutationObserver(() => this.updateVisibility());
-    // let debounceTimer = null;
-    // const observer = new MutationObserver(() => {
-    //   if (debounceTimer) clearTimeout(debounceTimer);
-    //   debounceTimer = setTimeout(() => this.updateVisibility(), 250);
-    // });
     observer.observe(document.body, { childList: true, subtree: true });
 
     document.body.addEventListener("click", () => this.updateVisibility());
@@ -1606,7 +1658,7 @@ const SlideCreator = {
           
           trailerUrl = {
               id: videoId,
-              url: `${STATE.jellyfinData.serverAddress}/Videos/${videoId}/stream.mp4?Static=true&api_key=${STATE.jellyfinData.accessToken}`
+              url: `${STATE.jellyfinData.serverAddress}/Videos/${videoId}/stream.mp4?api_key=${STATE.jellyfinData.accessToken}`
           };
       } else {
           // Assume it's a standard URL (YouTube, etc.)
@@ -1614,15 +1666,25 @@ const SlideCreator = {
           console.log(`Using custom trailer URL for ${itemId}: ${trailerUrl}`);
       }
     }
-    // 1b. Check Local Trailer if preferred
+    // 1b. Check Theme Video if preferred (Local Backdrop)
+    else if (CONFIG.preferLocalBackdrops && item.themeVideoUrl) {
+        trailerUrl = item.themeVideoUrl;
+        console.log(`Using theme video (local backdrop) for ${itemId}: ${trailerUrl.url || trailerUrl}`);
+    } 
+    // 1c. Check Local Trailer if preferred
     else if (CONFIG.preferLocalTrailers && item.LocalTrailerCount > 0 && item.localTrailerUrl) {
          trailerUrl = item.localTrailerUrl;
          console.log(`Using local trailer for ${itemId}: ${trailerUrl}`);
     }
-    // 1c. Fallback to Remote Trailer
+    // 1d. Fallback to Remote Trailer
     else if (item.RemoteTrailers && item.RemoteTrailers.length > 0) {
       trailerUrl = item.RemoteTrailers[0].Url;
     }
+    // 1e. Final Fallback to Local Trailer (even if not preferred)
+    else if (item.LocalTrailerCount > 0 && item.localTrailerUrl) {
+         trailerUrl = item.localTrailerUrl;
+         console.log(`Using local trailer fallback for ${itemId}: ${trailerUrl}`);
+    }
 
     const isMobile = /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(navigator.userAgent);
     
@@ -1715,13 +1777,6 @@ const SlideCreator = {
               playerVars: playerVars,
               events: {
                 'onReady': (event) => {
-                  // Prevent iframe from stealing focus (critical for TV mode)
-                  const iframe = event.target.getIframe();
-                  if (iframe) {
-                    iframe.setAttribute('tabindex', '-1');
-                    iframe.setAttribute('inert', '');
-                  }
-
                   // Store start/end time and videoId for later use
                   event.target._startTime = playerVars.start || 0;
                   event.target._endTime = playerVars.end || undefined;
@@ -1738,19 +1793,11 @@ const SlideCreator = {
                     event.target.setPlaybackQuality(quality);
                   }
 
-                  // Only play if this is the active slide AND the slideshow is visible
+                  // Only play if this is the active slide
                   const slide = document.querySelector(`.slide[data-item-id="${itemId}"]`);
                   const isVideoPlayerOpen = document.querySelector('.videoPlayerContainer') || document.querySelector('.youtubePlayerContainer');
 
                   if (slide && slide.classList.contains('active') && !document.hidden && (!isVideoPlayerOpen || isVideoPlayerOpen.classList.contains('hide'))) {
-                    // MARK: mark
-                    // const currentIndex = STATE.slideshow.currentSlideIndex;
-                    //   const currentItemId = STATE.slideshow.itemIds[currentIndex];
-                    //   if (currentItemId !== itemId) {
-                    //       console.log(`Slide ${itemId} is no longer active (current: ${currentItemId}), aborting playback.`);
-                    //       event.target.mute(); // Mute just in case
-                    //       return;
-                    //   }
                     event.target.playVideo();
                     
                     // Check if it actually started playing after a short delay (handling autoplay blocks)
@@ -1784,7 +1831,14 @@ const SlideCreator = {
                 },
                 'onStateChange': (event) => {
                   if (event.data === YT.PlayerState.ENDED) {
+                    const slide = document.querySelector(`.slide[data-item-id="${itemId}"]`);
+                    if (slide && slide.classList.contains('active')) {
+                      if (CONFIG.waitForTrailerToEnd) {
                         SlideshowManager.nextSlide();
+                      } else {
+                        event.target.playVideo(); // Loop if trailer is shorter than slide duration
+                      }
+                    }
                   }
                 },
                 'onError': (event) => {
@@ -1813,44 +1867,36 @@ const SlideCreator = {
           style: "object-fit: cover; object-position: center center; width: 100%; height: 100%; position: absolute; top: 0; left: 0; pointer-events: none;"
         };
 
-        if (STATE.slideshow.isMuted) {
         videoAttributes.muted = "";
-        }
 
         backdrop = SlideUtils.createElement("video", videoAttributes);
-
-        if (!STATE.slideshow.isMuted) {
         backdrop.volume = 0.4;
-        }
 
         STATE.slideshow.videoPlayers[itemId] = backdrop;
 
         backdrop.addEventListener('play', (event) => {
           const slide = document.querySelector(`.slide[data-item-id="${itemId}"]`);
-          // MARK: mark
-          // const currentIndex = STATE.slideshow.currentSlideIndex;
-          // const currentItemId = STATE.slideshow.itemIds[currentIndex];
-          
-          // if (!slide || !slide.classList.contains('active') || currentItemId !== itemId) {
-
           if (!slide || !slide.classList.contains('active')) {
-              console.log(`Local video ${itemId} started playing but is not active, pausing.`);
+            console.log(`Local video ${itemId} started playing but slide is not active, pausing.`);
             event.target.pause();
             event.target.currentTime = 0;
             return;
           }
-
           if (CONFIG.waitForTrailerToEnd && STATE.slideshow.slideInterval) {
             STATE.slideshow.slideInterval.stop();
           }
         });
 
         backdrop.addEventListener('ended', () => {
+            const slide = document.querySelector(`.slide[data-item-id="${itemId}"]`);
+            if (slide && slide.classList.contains('active')) {
               SlideshowManager.nextSlide();
+            }
         });
 
         backdrop.addEventListener('error', () => {
-          if (CONFIG.waitForTrailerToEnd) {
+          const slide = document.querySelector(`.slide[data-item-id="${itemId}"]`);
+          if (CONFIG.waitForTrailerToEnd && slide && slide.classList.contains('active')) {
             SlideshowManager.nextSlide();
           }
         });
@@ -2184,6 +2230,11 @@ const SlideCreator = {
           item.localTrailerUrl = await ApiUtils.fetchLocalTrailer(itemId);
       }
 
+      // Pre-fetch theme video URL if needed
+      if (CONFIG.preferLocalBackdrops) {
+          item.themeVideoUrl = await ApiUtils.fetchThemeVideos(itemId);
+      }
+
       const slideElement = this.createSlideElement(
         item,
         item.Type === "Movie" ? "Movie" : "TV Show"
@@ -2281,16 +2332,6 @@ const SlideshowManager = {
     let previousVisibleSlide;
     try {
       const container = SlideUtils.getOrCreateSlidesContainer();
-      
-      const activeElement = document.activeElement;
-      let focusSelector = null;
-      if (container.contains(activeElement)) {
-          if (activeElement.classList.contains('play-button')) focusSelector = '.play-button';
-          else if (activeElement.classList.contains('detail-button')) focusSelector = '.detail-button';
-          else if (activeElement.classList.contains('favorite-button')) focusSelector = '.favorite-button';
-          else if (activeElement.classList.contains('trailer-button')) focusSelector = '.trailer-button';
-      }
-
       const totalItems = STATE.slideshow.totalItems;
 
       index = Math.max(0, Math.min(index, totalItems - 1));
@@ -2319,27 +2360,111 @@ const SlideshowManager = {
 
       currentSlide.classList.add("active");
 
-      // Restore focus for TV mode navigation continuity
+      // Manage Video Playback: Stop others, Play current
-      requestAnimationFrame(() => {
+      // 1. Stop all other YouTube players and local video elements
-        if (focusSelector) {
+      if (STATE.slideshow.videoPlayers) {
-          const target = currentSlide.querySelector(focusSelector);
+        Object.keys(STATE.slideshow.videoPlayers).forEach(id => {
-          if (target) {
+          if (id !== currentItemId) {
-            target.focus();
+            const p = STATE.slideshow.videoPlayers[id];
-            return;
+            if (!p) return;
+            // YouTube player
+            if (typeof p.pauseVideo === 'function') {
+              p.pauseVideo();
+            }
+            // HTML5 <video> element (local trailers)
+            if (p instanceof HTMLVideoElement) {
+              p.pause();
+              p.muted = true;
+              p.currentTime = 0;
             }
           }
-        // Always ensure container has focus in TV mode to keep keyboard navigation working
+        });
-        const isTvMode = (window.layoutManager && window.layoutManager.tv) ||
+      }
-          document.documentElement.classList.contains('layout-tv') ||
+
-          document.body.classList.contains('layout-tv');
+      // 2. Pause all other HTML5 videos e.g. local trailers
-        if (isTvMode) {
+      document.querySelectorAll('video').forEach(video => {
-          container.focus({ preventScroll: true });
+        if (!video.closest(`.slide[data-item-id="${currentItemId}"]`)) {
+          video.pause();
         }
       });
 
-      // Manage Video Playback: Stop others, Play current
+      // 3. Play and Reset current video
-      this.pauseOtherVideos(currentItemId);
+      const videoBackdrop = currentSlide.querySelector('.video-backdrop');
-      this.playCurrentVideo(currentSlide, currentItemId);
+
+      // Auto-unpause when a video slide becomes active
+      if (videoBackdrop && STATE.slideshow.isPaused) {
+          STATE.slideshow.isPaused = false;
+          const pauseButton = document.querySelector('.pause-button');
+          if (pauseButton) {
+              pauseButton.innerHTML = '<i class="material-icons">pause</i>';
+              const pauseLabel = LocalizationUtils.getLocalizedString('ButtonPause', 'Pause');
+              pauseButton.setAttribute("aria-label", pauseLabel);
+              pauseButton.setAttribute("title", pauseLabel);
+          }
+      }
+
+      // Update mute button visibility
+      const muteButton = document.querySelector('.mute-button');
+      if (muteButton) {
+        const hasVideo = !!videoBackdrop;
+        muteButton.style.display = hasVideo ? 'block' : 'none';
+      }
+
+      if (videoBackdrop) {
+        if (videoBackdrop.tagName === 'VIDEO') {
+          videoBackdrop.currentTime = 0;
+
+          videoBackdrop.muted = STATE.slideshow.isMuted;
+          if (!STATE.slideshow.isMuted) {
+            videoBackdrop.volume = 0.4;
+          }
+
+          videoBackdrop.play().catch(e => {
+            // Check if it actually started playing after a short delay (handling autoplay blocks)
+            setTimeout(() => {
+              if (videoBackdrop.paused && currentSlide.classList.contains('active')) {
+                console.warn(`Autoplay blocked for ${currentItemId}, attempting muted fallback`);
+                videoBackdrop.muted = true;
+                videoBackdrop.play().catch(err => console.error("Muted fallback failed", err));
+              }
+            }, 1000);
+          });
+        } else if (STATE.slideshow.videoPlayers && STATE.slideshow.videoPlayers[currentItemId]) {
+          const player = STATE.slideshow.videoPlayers[currentItemId];
+          if (player && typeof player.loadVideoById === 'function' && player._videoId) {
+            // Use loadVideoById to enforce start and end times
+            player.loadVideoById({
+              videoId: player._videoId,
+              startSeconds: player._startTime || 0,
+              endSeconds: player._endTime
+            });
+
+            if (STATE.slideshow.isMuted) {
+              player.mute();
+            } else {
+              player.unMute();
+              player.setVolume(40);
+            }
+
+            // Check if playback successfully started, otherwise fallback to muted
+            setTimeout(() => {
+              if (!currentSlide.classList.contains('active')) return;
+              if (player.getPlayerState &&
+                player.getPlayerState() !== YT.PlayerState.PLAYING &&
+                player.getPlayerState() !== YT.PlayerState.BUFFERING) {
+                console.log("YouTube loadVideoById didn't start playback, retrying muted...");
+                player.mute();
+                player.playVideo();
+              }
+            }, 1000);
+          } else if (player && typeof player.seekTo === 'function') {
+            // Fallback if loadVideoById is not available or videoId missing
+            const startTime = player._startTime || 0;
+            player.seekTo(startTime);
+            player.playVideo();
+          }
+        }
+      }
 
       const enableAnimations = MediaBarEnhancedSettingsManager.getSetting('slideAnimations', CONFIG.slideAnimationEnabled);
 
@@ -2374,7 +2499,8 @@ const SlideshowManager = {
       this.updateDots();
 
       // Only restart interval if we are NOT waiting for a video to end
-      const hasVideo = currentSlide.querySelector('.video-backdrop');
+      const hasVideo = currentSlide.querySelector('.video-backdrop') || 
+        (STATE.slideshow.videoPlayers && STATE.slideshow.videoPlayers[currentItemId]);
       if (STATE.slideshow.slideInterval && !STATE.slideshow.isPaused) {
         if (CONFIG.waitForTrailerToEnd && hasVideo) {
           STATE.slideshow.slideInterval.stop();
@@ -2433,6 +2559,7 @@ const SlideshowManager = {
   async preloadAdjacentSlides(currentIndex) {
     const totalItems = STATE.slideshow.totalItems;
     const preloadCount = Math.min(Math.max(CONFIG.preloadCount || 1, 1), 5);
+    const preloadedIds = new Set();
 
     // Preload next slides
     for (let i = 1; i <= preloadCount; i++) {
@@ -2440,8 +2567,11 @@ const SlideshowManager = {
         if (nextIndex === currentIndex) break;
 
         const itemId = STATE.slideshow.itemIds[nextIndex];
+        if (!preloadedIds.has(itemId)) {
+             preloadedIds.add(itemId);
              SlideCreator.createSlideForItemId(itemId);
         }
+    }
 
     // Preload previous slides
     for (let i = 1; i <= preloadCount; i++) {
@@ -2449,8 +2579,11 @@ const SlideshowManager = {
         if (prevIndex === currentIndex) break;
 
         const prevItemId = STATE.slideshow.itemIds[prevIndex];
+        if (!preloadedIds.has(prevItemId)) {
+             preloadedIds.add(prevItemId);
              SlideCreator.createSlideForItemId(prevItemId);
         }
+    }
   },
 
   nextSlide() {
@@ -2485,8 +2618,6 @@ const SlideshowManager = {
       if (index === -1) return;
 
       const totalItems = STATE.slideshow.itemIds.length;
-      
-      // Calculate wrapped distance
       let distance = Math.abs(index - currentIndex);
       if (totalItems > keepRange * 2) {
           distance = Math.min(distance, totalItems - distance);
@@ -2516,13 +2647,11 @@ const SlideshowManager = {
       }
     });
 
-    // After pruning, restore focus to container in TV mode
     if (prunedAny) {
       const isTvMode = (window.layoutManager && window.layoutManager.tv) ||
         document.documentElement.classList.contains('layout-tv') ||
         document.body.classList.contains('layout-tv');
       if (isTvMode) {
-        // Use setTimeout to execute AFTER Jellyfin's focus manager processes the iframe removal
         setTimeout(() => {
           const container = document.getElementById("slides-container");
           if (container && container.style.display !== 'none') {
@@ -2649,116 +2778,6 @@ const SlideshowManager = {
     }
   },
 
-  /**
-   * Pauses all video players except the one with the given item ID
-   * @param {string} excludeItemId - Item ID to exclude from pausing
-   */
-  pauseOtherVideos(excludeItemId) {
-    // Pause YouTube players
-    if (STATE.slideshow.videoPlayers) {
-      Object.keys(STATE.slideshow.videoPlayers).forEach(id => {
-        if (id !== excludeItemId) {
-          const p = STATE.slideshow.videoPlayers[id];
-          if (p) {
-            try {
-              if (typeof p.pauseVideo === 'function') {
-                p.pauseVideo();
-                if (typeof p.mute === 'function') {
-                  p.mute();
-                }
-              }
-              else if (p.tagName === 'VIDEO') {
-                p.pause();
-                p.muted = true;
-              }
-            } catch (e) { console.warn("Error pausing player", id, e); }
-          }
-        }
-      });
-    }
-    // Pause HTML5 videos
-    document.querySelectorAll('video').forEach(video => {
-      const slideParent = video.closest('.slide');
-      if (slideParent && slideParent.dataset.itemId !== excludeItemId) {
-        try {
-          video.pause();
-          video.muted = true;
-        } catch (e) {}
-      }
-    });
-  },
-
-  /**
-   * Plays the video backdrop on the given slide and updates mute button visibility
-   * @param {Element} slide - The slide DOM element
-   * @param {string} itemId - The item ID of the slide
-   * @returns {boolean} Whether a video was found and playback attempted
-   */
-  playCurrentVideo(slide, itemId) {
-    const videoBackdrop = slide.querySelector('.video-backdrop');
-
-    // Update mute button visibility
-    const muteButton = document.querySelector('.mute-button');
-    if (muteButton) {
-      muteButton.style.display = videoBackdrop ? 'block' : 'none';
-    }
-
-    if (!videoBackdrop) return false;
-
-    if (videoBackdrop.tagName === 'VIDEO') {
-      videoBackdrop.currentTime = 0;
-      videoBackdrop.muted = STATE.slideshow.isMuted;
-      if (!STATE.slideshow.isMuted) videoBackdrop.volume = 0.4;
-
-      videoBackdrop.play().catch(() => {
-        setTimeout(() => {
-          if (videoBackdrop.paused) {
-            console.warn(`Autoplay blocked for ${itemId}, attempting muted fallback`);
-            videoBackdrop.muted = true;
-            videoBackdrop.play().catch(err => console.error("Muted fallback failed", err));
-          }
-        }, 1000);
-      });
-      return true;
-    }
-
-    // YouTube player
-    const player = STATE.slideshow.videoPlayers && STATE.slideshow.videoPlayers[itemId];
-    if (player && typeof player.loadVideoById === 'function' && player._videoId) {
-      player.loadVideoById({
-        videoId: player._videoId,
-        startSeconds: player._startTime || 0,
-        endSeconds: player._endTime
-      });
-      
-      if (STATE.slideshow.isMuted) {
-        player.mute();
-      } else {
-        player.unMute();
-        player.setVolume(40);
-      }
-
-      setTimeout(() => {
-        if (player.getPlayerState &&
-          player.getPlayerState() !== YT.PlayerState.PLAYING &&
-          player.getPlayerState() !== YT.PlayerState.BUFFERING) {
-          console.log("YouTube loadVideoById didn't start playback, retrying muted...");
-          player.mute();
-          player.playVideo();
-        }
-      }, 1000);
-      return true;
-    } else if (player && typeof player.seekTo === 'function') {
-      // Fallback if loadVideoById is not available or videoId missing but player object exists
-      const startTime = player._startTime || 0;
-      player.seekTo(startTime);
-      player.playVideo();
-      return true;
-    }
-
-    return false;
-  },
-
   /**
    * Stops all video playback (YouTube and HTML5)
    * Used when navigating away from the home screen
@@ -2907,7 +2926,7 @@ const SlideshowManager = {
       // Determine if we should handle navigation keys (Arrows, Space, M)
       // TV Mode: Strict focus required (must be on slideshow)
       // Desktop Mode: Loose focus allowed (slideshow OR body/nothing focused)
-      let canControlSlideshow = isTvMode ? hasDirectFocus : (hasDirectFocus || isBodyFocused);
+      const canControlSlideshow = isTvMode ? hasDirectFocus : (hasDirectFocus || isBodyFocused);
 
       // Check for Input Fields (always ignore typing)
       const isInputElement = activeElement && (activeElement.tagName === 'INPUT' || activeElement.tagName === 'TEXTAREA' || activeElement.isContentEditable);
@@ -3551,70 +3570,76 @@ const MediaBarEnhancedSettingsManager = {
  * Initialize page visibility handling to pause when tab is inactive
  */
 const initPageVisibilityHandler = () => {
-  document.addEventListener("visibilitychange", () => {
+  let wasVideoPlayingBeforeHide = false;
-    const isVideoPlayerOpen = document.querySelector('.videoPlayerContainer:not(.hide)') ||
-      document.querySelector('.youtubePlayerContainer:not(.hide)');
 
+  document.addEventListener("visibilitychange", () => {
     if (document.hidden) {
-      // Stop slide timer
+      console.log("Tab inactive - pausing slideshow and videos");
+      wasVideoPlayingBeforeHide = STATE.slideshow.isVideoPlaying;
+      
       if (STATE.slideshow.slideInterval) {
         STATE.slideshow.slideInterval.stop();
       }
       
-      if (isVideoPlayerOpen) {
+      // Pause active video if playing
-        // Jellyfin video is playing --> full stop to free all resources
+      const currentItemId = STATE.slideshow.itemIds[STATE.slideshow.currentSlideIndex];
-        console.log("Tab inactive and Jellyfin player active - stopping all playback");
-        SlideshowManager.stopAllPlayback();
-      } else {
-        // Simple tab switch: stop all others, pause only the current
-        console.log("Tab inactive. Pausing current video, stopping others");
-        const currentItemId = STATE.slideshow.itemIds?.[STATE.slideshow.currentSlideIndex];
-
-        // Stop all players except the current one
-        if (STATE.slideshow.videoPlayers) {
-          Object.keys(STATE.slideshow.videoPlayers).forEach(id => {
-            if (id === currentItemId) return;
-            const p = STATE.slideshow.videoPlayers[id];
-            if (p) {
-              try {
-                if (typeof p.stopVideo === 'function') {
-                  p.stopVideo();
-                  if (typeof p.clearVideo === 'function') p.clearVideo();
-                } else if (p.tagName === 'VIDEO') {
-                  p.pause();
-                  p.muted = true;
-                  p.currentTime = 0;
-                }
-              } catch (e) { console.warn("Error stopping background player", id, e); }
-            }
-          });
-        }
-
-        // Pause only the current video
       if (currentItemId) {
-          const player = STATE.slideshow.videoPlayers?.[currentItemId];
+        // YouTube
-          if (player) {
+        if (STATE.slideshow.videoPlayers && STATE.slideshow.videoPlayers[currentItemId]) {
+          const player = STATE.slideshow.videoPlayers[currentItemId];
+          if (typeof player.pauseVideo === "function") {
             try {
-              if (typeof player.pauseVideo === 'function') {
               player.pauseVideo();
-              } else if (player.tagName === 'VIDEO') {
+              STATE.slideshow.isVideoPlaying = false;
-                player.pause();
+            } catch (e) {
+              console.warn("Error pausing video on tab hide:", e);
             }
-            } catch (e) { console.warn("Error pausing video on tab hide:", e); }
+          } else if (player.tagName === 'VIDEO') { // HTML5 Video
+             player.pause();
+             STATE.slideshow.isVideoPlaying = false;
           }
         }
       }
     } else {
-      console.log("Tab active. Resuming slideshow");
+      console.log("Tab active - resuming slideshow");
-      const isOnHome = window.location.hash === "#/home.html" || window.location.hash === "#/home";
+      if (!STATE.slideshow.isPaused) {
+        const currentItemId = STATE.slideshow.itemIds[STATE.slideshow.currentSlideIndex];
         
-      if (isOnHome && !STATE.slideshow.isPaused && !isVideoPlayerOpen) {
+        if (wasVideoPlayingBeforeHide && currentItemId && STATE.slideshow.videoPlayers && STATE.slideshow.videoPlayers[currentItemId]) {
-        SlideshowManager.resumeActivePlayback();
+          const player = STATE.slideshow.videoPlayers[currentItemId];
           
-        if (STATE.slideshow.slideInterval && !CONFIG.waitForTrailerToEnd) {
+          // YouTube
+          if (typeof player.playVideo === "function") {
+            try {
+              player.playVideo();
+              STATE.slideshow.isVideoPlaying = true;
+            } catch (e) {
+              console.warn("Error resuming video on tab show:", e);
+              if (STATE.slideshow.slideInterval) {
                 STATE.slideshow.slideInterval.start();
               }
             }
+          } else if (player.tagName === 'VIDEO') { // HTML5 Video
+             try {
+                player.play().catch(e => console.warn("Error resuming HTML5 video:", e));
+                STATE.slideshow.isVideoPlaying = true;
+             } catch(e) { console.warn(e); }
+          }
+        } else {
+          // No video was playing, just restart interval
+          const activeSlide = document.querySelector('.slide.active');
+          const hasVideo = activeSlide && activeSlide.querySelector('.video-backdrop');
+          
+          if (CONFIG.waitForTrailerToEnd && hasVideo) {
+             // Don't restart interval if waiting for trailer
+          } else {
+             if (STATE.slideshow.slideInterval) {
+               STATE.slideshow.slideInterval.start();
+             }
+          }
+        }
+        wasVideoPlayingBeforeHide = false;
+      }
     }
   });
 };

README.md

@@ -20,11 +20,14 @@ This plugin is a fork and enhancement of the original [Media Bar by MakD](https:
   - [Configuration](#configuration)
     - [General Settings](#general-settings)
     - [Custom Content](#custom-content)
+    - [Content Sorting](#content-sorting)
+    - [Content Limits](#content-limits)
     - [Advanced Settings](#advanced-settings)
   - [Build The Plugin By Yourself](#build-the-plugin-by-yourself)
   - [Troubleshooting](#troubleshooting)
     - [Effects Not Showing](#effects-not-showing)
     - [Docker Permission Issues](#docker-permission-issues)
+  - [Credits](#credits)
   - [Contributing](#contributing)
 
 ---
@@ -97,6 +100,12 @@ This plugin builds upon the original Media Bar with new capabilities and improve
         <summary>Have a look:</summary>
         <img width="513" height="575" alt="Client-Settings" src="https://github.com/user-attachments/assets/3e29a84f-f8ea-4b7b-b561-80493cb1535b" />
         </details>
+    *   **Local Trailers Preference**: Option to prefer local trailers (from the media item) over online sources.
+    *   **Theme Video Support**: Option to prefer local theme videos (backdrops) over trailers.
+    *   **Randomization**: Options to randomize theme videos and local trailers if multiple versions exist.
+    *   **Include Watched Content**: Option to include watched items in the random slideshow.
+    *   **Content Sorting Options**: Sort content by various criteria such as PremiereDate, ProductionYear, Random, or Original order.
+    *   **Client-Side Settings**: Allow users to override settings locally on their device.
 
 ### Core Features
 *   **Immersive Slideshow**: Rotates through your media library
@@ -104,6 +113,7 @@ This plugin builds upon the original Media Bar with new capabilities and improve
 *   **Direct Play**: Click "Play" to start watching immediately
 *   **Details View**: Click "Info" to jump to the item's detail page
 *   **Add To Favorites**: Click the heart to add the item to your favorites
+*   **Customize**: Change the plugins behavior through the Jellyfin admin panel
 
 ## Installation
 
@@ -150,30 +160,62 @@ Configure the plugin via **Dashboard** > **Plugins** > **Media Bar Enhanced**.
 *   **Wait For Trailer To End**: Prevents slide transition until the video finishes.
 *   **Enable Mobile Video**: specific setting to allow video playback on mobile devices (disabled by default to save data/battery).
 *   **Show Trailer Button**: Adds a button to open the trailer in a popup modal if video backdrops are disabled (e.g. on mobile if trailers are disabled there)
+*   **Prefer Local Trailers**: If enabled, local trailers will be preferred over remote (YouTube) trailers.
+*   **Prefer Local Backdrops / Theme Videos**: If enabled, local backdrop videos (Theme Videos) will be preferred over trailers.
 
 ### Custom Content
 Define exactly what shows up in your bar.
 
 *   **Enable Custom Media IDs**: Restrict the slideshow to a specific list of IDs.
-    *   **Manual Trailer Override**: Add `[YouTube_URL]` after an ID to force a specific trailer.
+    *   **Manual Trailer Override**: Add `[YouTube_URL]` or `[Jellyfin_ID]` after an ID to force a specific trailer/video.
     *   Example ID: `a1b2c3d4e5... [https://www.youtube.com/watch?v=VIDEO_ID]`
+    *   Example ID: `z1b2c3d4e5... [Jellyfin_ID]`
+    *   **Example Mixed List**:
+        ```
+        a1b2c3d4e5f6...                         <-- Plays local item video
+        6bdu812812hd... [https://youtu.be/...]  <-- Item metadata + Custom YouTube Trailer
+        12h44h124sf7... [hdc78127z4ff...]       <-- Item metadata + Custom Jellyfin Trailer/Video etc.
+        ```
     *   Example Collection Name: `Halloween Collection [https://...] | My Description` (Note: Use `|` to separate description from name if using a name instead of an ID)
+*   **Apply Limits to Custom IDs**: If enabled, the "Content Limits" (see below) will also apply to your Custom Media IDs list. By default, custom lists show all listed items regardless of limits.
 *   **Enable Seasonal Content Mode**: Advanced date-based scheduling.
-    *   Format: `DD.MM-DD.MM | Name | ID1, ID2, ID3`
+    *   **GUI Configuration**: You can easily add "Seasons" via the **Add Season** button.
-    *   Example: `20.10-31.10 | Halloween | <ID_OF_HALLOWEEN_COLLECTION>`
+    *   **Active Period**: Select the Start and End Day/Month for each season.
-    *   If the current date matches a range, those IDs are used. Otherwise, it defaults to standard behavior or the Custom Media IDs list.
+    *   **Media IDs**: Enter the Comma-separated list of IDs (Movies, Series, Collections) for that season.
+    *   **Priority**: If the current date matches a defined season, those IDs are used. If multiple seasons overlap, the first matching one is used. If no season matches, it falls back to the Default Custom Media IDs.
 
 **How to get IDs:**
 Check the URL of an item in the web interface:
 `.../web/#/details?id=YOUR_ITEM_ID_HERE&...`
 
+### Content Sorting
+Customize the order of slides in the Media Bar.
+
+*   **Sort By**: Choose criteria like *Random*, *Premiere Date*, *Production Year*, *Critic Rating*, *Community Rating*, *Name*, or *Runtime*.
+*   **Sort Order**: Ascending or Descending.
+*   **Note**: Sorting applies to both server-fetched content AND Custom Media IDs. Select **Original** to preserve the exact order of your Custom Media IDs list.
+
+### Content Limits
+Fine-tune performance by limiting the number of items fetched from the server.
+
+*   **Total Max Items**: Maximum total items to fetch (combined).
+*   **Include Watched Content**: If enabled, the random slideshow will also include items that you have already watched.
+*   **Max Movies**: Maximum movies to include (for random selection).
+*   **Max Tv Shows**: Maximum TV shows to include (for random selection).
+*   **Preload Count**: Number of slides to preload for smooth transitions.
+    *   *Intelligent Preloading*: The plugin uses a safe preloading strategy that respects this count but handles small lists gracefully to avoid playback issues.
+*   **Max Pagination Dots**: Maximum number of dots to show. If exceeded, it switches to a counter (e.g., 1/20).
+
 ### Advanced Settings
 *   **Slide Animations**: Enable/disable the "Zoom In" effect.
 *   **Use SponsorBlock**: Skips non-content segments in YouTube trailers (if the data exists).
+*   **Preferred YouTube Quality**: Select your preferred resolution (*Auto*, *Maximum*, *1080p*, *720p*).
 *   **Start Muted**: Videos start without sound (user can unmute).
 *   **Full Width Video**: Stretches video to cover the entire width (good for desktop, crop on mobile).
 *   **Enable Loading Screen**: Enable/disable the loading indicator while the bar initializes.
 *   **Always Show Arrows**: Keeps navigation arrows visible instead of hiding them on mouse leave.
+*   **Randomize Backdrop Video**: If enabled, a random video from the backdrops/theme videos will be selected instead of the first one.
+*   **Randomize Local Trailer**: If enabled, a random local trailer will be selected instead of the first one.
 *   **Enable Keyboard Controls**:
     *   `Left`/`Right`: Change slide
     *   `Space`: Pause/Play slideshow
@@ -244,6 +286,12 @@ volumes:
   - /path/to/jellyfin/config/index.html:/jellyfin/jellyfin-web/index.html
 ```
 
+## Credits
+
+This project is based on the original [Jellyfin Media Bar by MakD](https://github.com/MakD/Jellyfin-Media-Bar) and incorporates concepts from [IAmParadox27's plugin fork](https://github.com/IAmParadox27/jellyfin-plugin-media-bar). Thanks for their work!
+
+Also, special thanks to IAmParadox27 for the [File Transformation plugin](https://github.com/IAmParadox27/jellyfin-plugin-file-transformation) which this plugin can optionally use for improved Docker compatibility.
+
 ## Contributing
 
 Feel free to contribute to this project by creating pull requests or reporting issues.

RELEASE_GUIDE.md

@@ -43,7 +43,7 @@ Bevor du baust, musst du die Versionsnummer in den folgenden Dateien aktualisier
 Führe den folgenden Befehl im Terminal (PowerShell) im Hauptverzeichnis aus. Wir nutzen hier `dotnet build` statt `publish`, um unnötige Dateien zu vermeiden.
 
 ```powershell
-dotnet build Jellyfin.Plugin.MediaBar/Jellyfin.Plugin.MediaBar.csproj --configuration Release --output bin/Publish; Compress-Archive -Path bin/Publish/* -DestinationPath bin/Publish/Jellyfin.Plugin.MediaBar.zip -Force; $hash = (Get-FileHash -Algorithm MD5 bin/Publish/Jellyfin.Plugin.MediaBar.zip).Hash.ToLower(); $time = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ"); Write-Output "`n----------------------------------------"; Write-Output "NEUE CHECKSUMME (MD5): $hash"; Write-Output "ZEITSTEMPEL:           $time"; Write-Output "----------------------------------------`n"
+dotnet build Jellyfin.Plugin.MediaBarEnhanced/Jellyfin.Plugin.MediaBarEnhanced.csproj --configuration Release --output bin/Publish; Compress-Archive -Path bin/Publish/* -DestinationPath bin/Publish/Jellyfin.Plugin.MediaBarEnhanced.zip -Force; $hash = (Get-FileHash -Algorithm MD5 bin/Publish/Jellyfin.Plugin.MediaBarEnhanced.zip).Hash.ToLower(); $time = (Get-Date).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ"); Write-Output "`n----------------------------------------"; Write-Output "NEUE CHECKSUMME (MD5): $hash"; Write-Output "ZEITSTEMPEL:           $time"; Write-Output "----------------------------------------`n"
 ```
 
 ## 3. Manifest aktualisieren

manifest.json

@@ -9,12 +9,28 @@
     "imageUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/raw/branch/main/logo.png",
     "versions": [
       {
-        "version": "1.6.1.17",
+        "version": "1.6.3.0",
-        "changelog": "- fix tv mode issue\n- refactor video playback management",
+        "changelog": "- fix path issue on subpath installations",
         "targetAbi": "10.11.0.0",
-        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.6.1.17/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.6.3.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
-        "checksum": "4f0f1b0bfcb073ae72c6a5ba3b991e65",
+        "checksum": "e95e4775bcba615c63cbc73e414dd50c",
-        "timestamp": "2026-02-13T13:49:22Z"
+        "timestamp": "2026-02-15T01:21:06Z"
+      },
+      {
+        "version": "1.6.2.3",
+        "changelog": "- feat: add options for local backdrops (theme videos) support and randomization features for local trailer/backdrops if more than one is available\n- feat: add option to include watched content in the random selection",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.6.2.3/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "c7ff2d783889c25b5a53783bfbe30b11",
+        "timestamp": "2026-02-15T00:38:07Z"
+      },
+      {
+        "version": "1.6.1.32",
+        "changelog": "- feat: add seasonal UI logic\n- add option to also set the limits for custom ids\n- fix tv mode scroll issue\n- smaller fixes and improvements",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.6.1.32/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "e196fd393ef0bcf51f8ce535103f1811",
+        "timestamp": "2026-02-14T16:34:32Z"
       },
       {
         "version": "1.6.0.2",

test_scripts/check_backdrop_fields.js

@@ -0,0 +1,116 @@
+(async () => {
+    // 1. Initialisierung
+    const apiClient = window.ApiClient;
+    if (!apiClient) {
+        console.error("❌ ApiClient nicht gefunden. Bitte in der Browser-Konsole einer Jellyfin-Seite ausführen.");
+        return;
+    }
+
+    // 2. Item ID abfragen oder festlegen
+    let itemId = prompt("Bitte die Item ID eingeben (von einem Film/Serie mit Theme Video/Backdrop Video):");
+    if (!itemId) {
+        console.warn("Keine Item ID eingegeben. Abbruch.");
+        return;
+    }
+    itemId = itemId.trim();
+
+    const userId = apiClient.getCurrentUserId();
+    console.log(`%c🔍 Untersuche Item: ${itemId}`, "color: #00a4dc; font-size: 1.2em; font-weight: bold;");
+
+    // 3. Helper Funktion für Fetch requests
+    const fetchJson = async (url) => {
+        try {
+            const res = await fetch(url, {
+                headers: {
+                    'Authorization': `MediaBrowser Client="Jellyfin Web", Device="Browser", DeviceId="${apiClient.deviceId()}", Version="${apiClient.appVersion()}", Token="${apiClient.accessToken()}"`
+                }
+            });
+            if (res.ok) return await res.json();
+            console.warn(`⚠️ Request fehlgeschlagen: ${url} (${res.status})`);
+            return null;
+        } catch (e) {
+            console.error(`❌ Fehler bei Request: ${url}`, e);
+            return null;
+        }
+    };
+
+    // ---------------------------------------------------------
+    // TEST 1: Standard Item Details mit erweiterten Feldern
+    // ---------------------------------------------------------
+    console.group("1. Standard Item Details (mit Fields)");
+    const fields = "Overview,RemoteTrailers,MediaSources,LocalTrailerCount,ThemeVideoIds,ThemeSongIds";
+    const itemDetailsUrl = `${apiClient.serverAddress()}/Users/${userId}/Items/${itemId}?Fields=${fields}`;
+    
+    const item = await fetchJson(itemDetailsUrl);
+    if (item) {
+        console.log("Name:", item.Name);
+        console.log("ThemeVideoIds:", item.ThemeVideoIds);
+        console.log("ThemeSongIds:", item.ThemeSongIds);
+        console.log("LocalTrailerCount:", item.LocalTrailerCount);
+        console.log("RemoteTrailers:", item.RemoteTrailers);
+        
+        if (item.ThemeVideoIds && item.ThemeVideoIds.length > 0) {
+            console.log(`%c✅ ThemeVideoIds gefunden: ${item.ThemeVideoIds.length}`, "color: green; font-weight: bold;");
+        } else {
+             console.log(`%c❌ Keine ThemeVideoIds im Item-Objekt.`, "color: orange;");
+        }
+    }
+    console.groupEnd();
+
+    // ---------------------------------------------------------
+    // TEST 2: ThemeMedia Endpoint
+    // ---------------------------------------------------------
+    console.group("2. Endpoint: /Items/{Id}/ThemeMedia");
+    const themeMediaUrl = `${apiClient.serverAddress()}/Items/${itemId}/ThemeMedia?userId=${userId}`;
+    const themeMedia = await fetchJson(themeMediaUrl);
+    
+    if (themeMedia) {
+        console.dir(themeMedia);
+        if (themeMedia.ThemeVideos && themeMedia.ThemeVideos.length > 0) {
+            console.log(`%c✅ ThemeVideos gefunden: ${themeMedia.ThemeVideos.length}`, "color: green; font-weight: bold;");
+            themeMedia.ThemeVideos.forEach(v => console.log(`   - ID: ${v.Id}, Name: ${v.Name}, Path: ${v.Path}`));
+        } else {
+            console.log("❌ Keine ThemeVideos in ThemeMedia gefunden.");
+        }
+    }
+    console.groupEnd();
+
+    // ---------------------------------------------------------
+    // TEST 3: ThemeVideos Endpoint (Spezifisch)
+    // ---------------------------------------------------------
+    console.group("3. Endpoint: /Items/{Id}/ThemeVideos");
+    // Manchmal auch unter Users/{UserId}/Items/{Id}/ThemeVideos
+    const themeVideosUrl = `${apiClient.serverAddress()}/Items/${itemId}/ThemeVideos?userId=${userId}`;
+    const themeVideos = await fetchJson(themeVideosUrl);
+    
+    if (themeVideos) {
+        // Kann Array oder Objekt mit Items sein
+        const videos = Array.isArray(themeVideos) ? themeVideos : (themeVideos.Items || []);
+        console.dir(videos);
+        
+        if (videos.length > 0) {
+             console.log(`%c✅ ThemeVideos Endpoint lieferte Ergebnisse: ${videos.length}`, "color: green; font-weight: bold;");
+        } else {
+             console.log("❌ ThemeVideos Endpoint lieferte leeres Array.");
+        }
+    }
+    console.groupEnd();
+
+    // ---------------------------------------------------------
+    // TEST 4: LocalTrailers Endpoint
+    // ---------------------------------------------------------
+    console.group("4. Endpoint: /Items/{Id}/LocalTrailers");
+    const localTrailersUrl = `${apiClient.serverAddress()}/Users/${userId}/Items/${itemId}/LocalTrailers`;
+    const localTrailers = await fetchJson(localTrailersUrl);
+
+    if (localTrailers && localTrailers.length > 0) {
+        console.log(`%cℹ️ LocalTrailers gefunden: ${localTrailers.length}`, "color: blue;");
+        console.dir(localTrailers);
+    } else {
+        console.log("❌ Keine LocalTrailers gefunden.");
+    }
+    console.groupEnd();
+
+    console.log("%cFertig.", "font-weight: bold;");
+
+})();

test_scripts/fetch_specific_items_with_fields.js

@@ -0,0 +1,37 @@
+(async () => {
+    const apiClient = window.ApiClient;
+    if (!apiClient) {
+        console.error("ApiClient nicht gefunden.");
+        return;
+    }
+
+    const itemId = "DEINE_ITEM_ID_HIER";
+    const userId = apiClient.getCurrentUserId();
+    
+    const fields = "Overview,RemoteTrailers,Genres,CommunityRating,CriticRating,OfficialRating,PremiereDate,ProductionYear,MediaSources,RunTimeTicks,LocalTrailerCount,ThemeVideoIds";
+
+    try {
+        console.log(`Rufe erweiterte Details für Item ${itemId} ab...`);
+
+        const url = apiClient.getUrl(`Users/${userId}/Items/${itemId}`, {
+            Fields: fields
+        });
+
+        const item = await apiClient.getJSON(url);
+
+        if (item) {
+            console.log(`%cErgebnis für: ${item.Name}`, "color: #00a4dc; font-weight: bold;");
+            
+            console.log("Remote Trailer:", item.RemoteTrailers);
+            console.log("Local Trailer Count:", item.LocalTrailerCount);
+            console.log("Media Sources:", item.MediaSources);
+            console.log("ThemeVideos:", item.ThemeVideoIds);
+            
+            console.dir(item);
+        } else {
+            console.warn("Item konnte nicht gefunden werden.");
+        }
+    } catch (error) {
+        console.error("Fehler beim Abrufen des Items:", error);
+    }
+})();