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

Jellyfin.Plugin.MediaBarEnhanced/Api/OverlayImageController.cs

@@ -0,0 +1,89 @@
+using System;
+using System.IO;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Mvc;
+using MediaBrowser.Common.Configuration;
+
+namespace Jellyfin.Plugin.MediaBarEnhanced.Api
+{
+    /// <summary>
+    /// Controller for handling custom overlay image uploads and retrieval.
+    /// </summary>
+    [ApiController]
+    [Route("MediaBarEnhanced")]
+    public class OverlayImageController : ControllerBase
+    {
+        private readonly IApplicationPaths _applicationPaths;
+        private readonly string _imageDirectory;
+        private readonly string _imagePath;
+
+        public OverlayImageController(IApplicationPaths applicationPaths)
+        {
+            _applicationPaths = applicationPaths;
+            
+            // We use the plugin's data folder to store the image
+            _imageDirectory = MediaBarEnhancedPlugin.Instance?.DataFolderPath ?? Path.Combine(applicationPaths.DataPath, "plugins", "MediaBarEnhanced");
+            
+            // We'll just overwrite this single file each time
+            _imagePath = Path.Combine(_imageDirectory, "custom_overlay_image.dat");
+        }
+
+        /// <summary>
+        /// Uploads a new custom overlay image.
+        /// </summary>
+        [HttpPost("OverlayImage")]
+        [Consumes("multipart/form-data")]
+        public async Task<IActionResult> UploadImage([FromForm] IFormFile file)
+        {
+            if (file == null || file.Length == 0)
+            {
+                return BadRequest("No file uploaded.");
+            }
+
+            try
+            {
+                if (!Directory.Exists(_imageDirectory))
+                {
+                    Directory.CreateDirectory(_imageDirectory);
+                }
+
+                // Delete is not strictly necessary and can cause locking issues if someone is currently reading it.
+                // FileMode.Create will truncate the file if it exists, effectively overwriting it.
+                // We use FileShare.None to ensure we have exclusive write access, but handle potential IOExceptions gracefully.
+                using (var stream = new FileStream(_imagePath, FileMode.Create, FileAccess.Write, FileShare.None))
+                {
+                    await file.CopyToAsync(stream).ConfigureAwait(false);
+                }
+
+                // Return the GET URL that the frontend can use
+                var getUrl = "/MediaBarEnhanced/OverlayImage?t=" + DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
+                return Ok(new { url = getUrl });
+            }
+            catch (Exception ex)
+            {
+                return StatusCode(500, $"Internal server error: {ex.Message}");
+            }
+        }
+
+        /// <summary>
+        /// Retrieves the custom overlay image.
+        /// </summary>
+        [HttpGet("OverlayImage")]
+        public IActionResult GetImage()
+        {
+            if (!System.IO.File.Exists(_imagePath))
+            {
+                return NotFound();
+            }
+
+            // Read the file and return as a generic octet stream. 
+            // We use FileShare.ReadWrite so that if someone is currently overwriting the file (uploading), we don't block them,
+            // and we also don't get blocked by other readers.
+            var stream = new FileStream(_imagePath, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
+            
+            // "image/*" works reliably as browsers will sniff the exact image mime type (jpeg, png, webp).
+            return File(stream, "image/*");
+        }
+    }
+}

Jellyfin.Plugin.MediaBarEnhanced/Configuration/PluginConfiguration.cs

@@ -36,6 +36,7 @@ namespace Jellyfin.Plugin.MediaBarEnhanced.Configuration
         public bool EnableLoadingScreen { get; set; } = true;
         public bool EnableKeyboardControls { get; set; } = true;
         public bool AlwaysShowArrows { get; set; } = false;
+        public bool HideArrowsOnMobile { get; set; } = true;
         public string CustomMediaIds { get; set; } = "";
         public bool EnableCustomMediaIds { get; set; } = true;
         public string PreferredVideoQuality { get; set; } = "Auto";
@@ -48,5 +49,10 @@ namespace Jellyfin.Plugin.MediaBarEnhanced.Configuration
         public bool IncludeWatchedContent { get; set; } = false;
         public string SortBy { get; set; } = "Random";
         public string SortOrder { get; set; } = "Ascending";
+        
+        public bool EnableCustomOverlay { get; set; } = false;
+        public string CustomOverlayText { get; set; } = "";
+        public string CustomOverlayImageUrl { get; set; } = "";
+        public string CustomOverlayStyle { get; set; } = "Shadowed";
     }
 }

Jellyfin.Plugin.MediaBarEnhanced/Configuration/configPage.html

@@ -78,7 +78,7 @@
                             <div class="fieldDescription">If enabled, local backdrop videos (Theme Videos) will be
                                 preferred over remote and local trailers.</div>
                         </div>
-                        <div class="checkboxContainer checkboxContainer-withDescription">
+                        <div class="checkboxContainer checkboxContainer-withDescription" id="WaitForTrailerToEndContainer">
                             <label>
                                 <input is="emby-checkbox" type="checkbox" id="WaitForTrailerToEnd"
                                     name="WaitForTrailerToEnd" />
@@ -86,7 +86,7 @@
                             </label>
                             <div class="fieldDescription">Delay slide transition until trailer finishes.</div>
                         </div>
-                        <div class="checkboxContainer checkboxContainer-withDescription">
+                        <div class="checkboxContainer checkboxContainer-withDescription" id="EnableMobileVideoContainer">
                             <label>
                                 <input is="emby-checkbox" type="checkbox" id="EnableMobileVideo"
                                     name="EnableMobileVideo" />
@@ -100,8 +100,8 @@
                                     name="ShowTrailerButton" />
                                 <span>Show Trailer Button</span>
                             </label>
-                            <div class="fieldDescription">Display a button to open trailer in modal. Only visible if
-                                trailer is not set as backdrop or if no trailer is available.</div>
+                            <div class="fieldDescription">Display a button to open trailer in modal. Button only
+                                visible if trailer is not set as backdrop.</div>
                         </div>
                     </div>
 
@@ -183,15 +183,15 @@
                                 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 class="checkboxContainer checkboxContainer-withDescription">
-                            <label>
-                                <input is="emby-checkbox" type="checkbox" id="ExcludeSeasonalContent"
-                                    name="ExcludeSeasonalContent" />
-                                <span>Exclude Seasonal Content from Random Lists</span>
-                            </label>
-                            <div class="fieldDescription">When enabled, any items defined in your Seasonal Sections below will be explicitly excluded from being shown when the plugin pulls random items from your library.</div>
-                        </div>
                         <div id="seasonalContentContainer" style="display: none;">
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label>
+                                    <input is="emby-checkbox" type="checkbox" id="ExcludeSeasonalContent"
+                                        name="ExcludeSeasonalContent" />
+                                    <span>Exclude Seasonal Content from Random Lists</span>
+                                </label>
+                                <div class="fieldDescription">When enabled, any items defined in your Seasonal Sections below will be explicitly excluded from being shown when the plugin pulls random items from your library.</div>
+                            </div>
 
                             <div
                                 style="background-color: rgba(255, 255, 255, 0.05); border-left: 4px solid #00a4dc; border-radius: 4px; padding: 1em 1.5em; margin: 1.5em 0; display: flex; align-items: center; gap: 1em;">
@@ -210,6 +210,62 @@
                         <input type="hidden" id="SeasonalSections" name="SeasonalSections" value="[]" />
                     </div>
 
+                    <!-- CUSTOM OVERLAY TAB -->
+                    <div id="media-bar-enhanced-overlay" class="tab-content" style="display:none;">
+                        <h2 class="sectionTitle">Custom Slideshow Overlay</h2>
+                        <p>Inject a custom text or floating image over the slideshow. This can be overridden by specific Seasonal Sections in the Custom Filters tab.</p>
+                        
+                        <div class="checkboxContainer checkboxContainer-withDescription">
+                            <label>
+                                <input is="emby-checkbox" type="checkbox" id="EnableCustomOverlay" name="EnableCustomOverlay" />
+                                <span>Enable Custom Overlay</span>
+                            </label>
+                            <div class="fieldDescription">If enabled, the text or image below will hover over the slideshow globally.</div>
+                        </div>
+
+                        <div class="selectContainer">
+                            <label class="selectLabel" for="CustomOverlayStyle">Overlay Style</label>
+                            <select is="emby-select" id="CustomOverlayStyle" name="CustomOverlayStyle"
+                                class="selectLayout emby-select-withcolor emby-select"
+                                style="width: 100%; -webkit-appearance: menulist; appearance: menulist;">
+                                <option value="Shadowed">Classic Shadowed</option>
+                                <option value="Frosted">Frosted Glass Pill</option>
+                                <option value="Cinematic">Cinematic Golden Glow</option>
+                                <option value="Pulse">Animated Pulse</option>
+                            </select>
+                            <div class="fieldDescription">Choose the visual styling animation for your custom text.</div>
+                        </div>
+
+                        <div class="inputContainer">
+                            <label class="inputLabel inputLabelUnfocused" for="CustomOverlayText">Global Overlay Text</label>
+                            <input is="emby-input" type="text" id="CustomOverlayText" name="CustomOverlayText" />
+                            <div class="fieldDescription">Text to display on the overlay (e.g. "Movie Night!"). Leave blank to use an image instead.</div>
+                        </div>
+
+                        <h3 class="inputLabel" style="margin-top: 2em;">Global Overlay Image</h3>
+                        <div class="inputContainer">
+                            <label class="inputLabel inputLabelUnfocused" for="CustomOverlayImageUrl">Global Overlay Image URL</label>
+                            <input is="emby-input" type="text" id="CustomOverlayImageUrl" name="CustomOverlayImageUrl" />
+                            <div class="fieldDescription">Absolute URL to an image to display on the overlay. If provided, this overrides the text above.</div>
+                        </div>
+
+                        <!-- Image Upload Dropzone -->
+                        <div class="inputContainer" style="margin-top: 1em;">
+                            <label class="inputLabel">Or Upload Local Image</label>
+                            <div id="overlayImageDropzone" style="border: 2px dashed rgba(255,255,255,0.2); border-radius: 8px; padding: 2em; text-align: center; cursor: pointer; background: rgba(0,0,0,0.2); transition: all 0.2s ease; position: relative; min-height: 120px; display: flex; flex-direction: column; align-items: center; justify-content: center;">
+                                <i class="material-icons" style="font-size: 40px; color: rgba(255,255,255,0.4); margin-bottom: 10px;">cloud_upload</i>
+                                <span style="font-size: 1.1em; color: rgba(255,255,255,0.7);">Drag and drop an image here, or click to select</span>
+                                <input type="file" id="overlayImageInput" accept="image/png, image/jpeg, image/gif, image/webp" style="display: none;">
+                                <img id="overlayImagePreview" style="display: none; max-width: 100%; max-height: 150px; position: absolute; top: 50%; left: 50%; transform: translate(-50%, -50%); border-radius: 4px; z-index: 2;" />
+                                <!-- A semi-transparent overlay to clear the image -->
+                                <button type="button" id="clearOverlayImageBtn" is="paper-icon-button-light" style="display: none; position: absolute; top: 10px; right: 10px; z-index: 3; background: rgba(0,0,0,0.6); border-radius: 50%; padding: 5px;" title="Clear Image">
+                                    <i class="material-icons" style="color: white;">close</i>
+                                </button>
+                            </div>
+                            <div class="fieldDescription">Uploading an image will securely save it to the server and automatically update the URL field above.</div>
+                        </div>
+                    </div>
+
                     <!-- ADVANCED TAB -->
                     <div id="media-bar-enhanced-advanced" class="tab-content" style="display:none;">
                         <h2 class="sectionTitle">Features</h2>
@@ -299,16 +355,23 @@
                                 <span>Enable Loading Screen</span>
                             </label>
                             <div class="fieldDescription">Show a loading screen while the slideshow initializes. (You
-                                may have to reload the page twice)</div>
+                                may have to reload the page twice (after changing this setting) to take effect)</div>
                         </div>
                         <div class="checkboxContainer checkboxContainer-withDescription">
                             <label>
                                 <input is="emby-checkbox" type="checkbox" id="AlwaysShowArrows"
                                     name="AlwaysShowArrows" />
-                                <span>Always Show Arrows</span>
+                                <span>Always Show Arrow Navigation Buttons</span>
                             </label>
-                            <div class="fieldDescription">If enabled, navigation arrows will always be visible instead
-                                of only on hover.</div>
+                            <div class="fieldDescription">Force the UI arrow navigation buttons to always be visible instead of only when hovered.</div>
+                        </div>
+                        <div class="checkboxContainer checkboxContainer-withDescription">
+                            <label>
+                                <input is="emby-checkbox" type="checkbox" id="HideArrowsOnMobile"
+                                    name="HideArrowsOnMobile" />
+                                <span>Hide Arrows on Mobile</span>
+                            </label>
+                            <div class="fieldDescription">Completely disable the navigation arrows on mobile devices (since swiping is available).</div>
                         </div>
                         <div class="checkboxContainer checkboxContainer-withDescription">
                             <label>
@@ -320,6 +383,7 @@
                                 Space (pause), M (mute/unmute)) for
                                 the slideshow.</div>
                         </div>
+                        <hr style="max-width: 800px; margin: 1em 0;">
 
                         <h2 class="sectionTitle">Time Settings</h2>
                         <p>Leave a setting blank to use the default value.</p>
@@ -363,6 +427,7 @@
                             <div class="fieldDescription">Minimum distance in pixels for a swipe to be registered (for
                                 mobile).</div>
                         </div>
+                        <hr style="max-width: 800px; margin: 1em 0;">
 
                         <h2 class="sectionTitle">Content Sorting and Filtering</h2>
                         <div class="selectContainer">
@@ -405,6 +470,16 @@
                             <input is="emby-input" type="number" id="MaxDaysRecent" name="MaxDaysRecent" />
                             <div class="fieldDescription">Only show items added in the last X days. Leave blank or set to 0 for no limit. Example: 30.</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>
+                        <hr style="max-width: 800px; margin: 1em 0;">
 
                         <h2 class="sectionTitle">Content Limits</h2>
                         <p>Leave a setting blank to use the default value.</p>
@@ -435,7 +510,7 @@
                             <label>
                                 <input is="emby-checkbox" type="checkbox" id="ShowPaginationDots"
                                     name="ShowPaginationDots" />
-                                <span>Show Pagination Dots</span>
+                                <span>Show Pagination Dots/Counter</span>
                             </label>
                             <div class="fieldDescription">Show or hide the pagination dots/counter navigation at the
                                 bottom of the slideshow.</div>
@@ -454,15 +529,6 @@
                             <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
@@ -524,7 +590,9 @@
                             'PreferLocalTrailers', 'ApplyLimitsToCustomIds', 'SeasonalSections',
                             'PreferLocalBackdrops', 'RandomizeThemeVideos', 'RandomizeLocalTrailers',
                             'IncludeWatchedContent', 'ShowPaginationDots', 'MaxParentalRating',
-                            'MaxDaysRecent', 'ExcludeSeasonalContent'
+                            'MaxDaysRecent', 'ExcludeSeasonalContent', 'HideArrowsOnMobile',
+                            'EnableCustomOverlay', 'CustomOverlayText', 'CustomOverlayImageUrl',
+                            'CustomOverlayStyle'
                         ];
 
                         // Manual mapping for MediaBarIsEnabled -> IsEnabled, to avoid conflicts with other plugins
@@ -582,14 +650,20 @@
                         var enableVideoBackdropCheckbox = page.querySelector('#EnableVideoBackdrop');
                         var preferLocalContainer = page.querySelector('#PreferLocalTrailersContainer');
                         var preferLocalBackdropsContainer = page.querySelector('#PreferLocalBackdropsContainer');
+                        var waitForTrailerContainer = page.querySelector('#WaitForTrailerToEndContainer');
+                        var enableMobileVideoContainer = page.querySelector('#EnableMobileVideoContainer');
 
                         function updatePreferLocalVisibility() {
                             if (enableVideoBackdropCheckbox && enableVideoBackdropCheckbox.checked) {
                                 if (preferLocalContainer) preferLocalContainer.style.display = 'block';
                                 if (preferLocalBackdropsContainer) preferLocalBackdropsContainer.style.display = 'block';
+                                if (waitForTrailerContainer) waitForTrailerContainer.style.display = 'block';
+                                if (enableMobileVideoContainer) enableMobileVideoContainer.style.display = 'block';
                             } else {
                                 if (preferLocalContainer) preferLocalContainer.style.display = 'none';
                                 if (preferLocalBackdropsContainer) preferLocalBackdropsContainer.style.display = 'none';
+                                if (waitForTrailerContainer) waitForTrailerContainer.style.display = 'none';
+                                if (enableMobileVideoContainer) enableMobileVideoContainer.style.display = 'none';
                             }
                         }
 
@@ -598,6 +672,108 @@
                             updatePreferLocalVisibility();
                         }
 
+                        // Overlay Image Upload Logic
+                        var dropzone = page.querySelector('#overlayImageDropzone');
+                        var fileInput = page.querySelector('#overlayImageInput');
+                        var urlInput = page.querySelector('#CustomOverlayImageUrl');
+                        var previewImg = page.querySelector('#overlayImagePreview');
+                        var clearBtn = page.querySelector('#clearOverlayImageBtn');
+
+                        function updatePreview() {
+                            if (urlInput.value && urlInput.value.trim() !== '') {
+                                previewImg.src = urlInput.value;
+                                previewImg.style.display = 'block';
+                                clearBtn.style.display = 'block';
+                            } else {
+                                previewImg.style.display = 'none';
+                                clearBtn.style.display = 'none';
+                            }
+                        }
+
+                        // Initial check
+                        updatePreview();
+
+                        // Listen to manual URL input changes
+                        urlInput.addEventListener('input', updatePreview);
+
+                        clearBtn.addEventListener('click', function(e) {
+                            e.stopPropagation(); // prevent triggering file dialog
+                            urlInput.value = '';
+                            fileInput.value = '';
+                            updatePreview();
+                        });
+
+                        dropzone.addEventListener('click', function() {
+                            fileInput.click();
+                        });
+
+                        dropzone.addEventListener('dragover', function(e) {
+                            e.preventDefault();
+                            dropzone.style.borderColor = '#00a4dc';
+                            dropzone.style.background = 'rgba(0, 164, 220, 0.2)';
+                        });
+
+                        dropzone.addEventListener('dragleave', function(e) {
+                            e.preventDefault();
+                            dropzone.style.borderColor = 'rgba(255,255,255,0.2)';
+                            dropzone.style.background = 'rgba(0,0,0,0.2)';
+                        });
+
+                        dropzone.addEventListener('drop', function(e) {
+                            e.preventDefault();
+                            dropzone.style.borderColor = 'rgba(255,255,255,0.2)';
+                            dropzone.style.background = 'rgba(0,0,0,0.2)';
+                            
+                            if (e.dataTransfer.files && e.dataTransfer.files.length > 0) {
+                                fileInput.files = e.dataTransfer.files;
+                                uploadImage(e.dataTransfer.files[0]);
+                            }
+                        });
+
+                        fileInput.addEventListener('change', function() {
+                            if (this.files && this.files.length > 0) {
+                                uploadImage(this.files[0]);
+                            }
+                        });
+
+                        function uploadImage(file) {
+                            // Validate it's an image
+                            if (!file.type.match('image.*')) {
+                                Dashboard.alert('Please select a valid image file.');
+                                return;
+                            }
+
+                            Dashboard.showLoadingMsg();
+                            
+                            var formData = new FormData();
+                            formData.append('file', file);
+
+                            // The Endpoint we created in C#
+                            fetch(ApiClient.serverAddress() + '/MediaBarEnhanced/OverlayImage', {
+                                method: 'POST',
+                                body: formData,
+                                headers: {
+                                    'Authorization': 'MediaBrowser Client="' + ApiClient.appName() + '", Device="' + ApiClient.deviceName() + '", DeviceId="' + ApiClient.deviceId() + '", Version="' + ApiClient.appVersion() + '", Token="' + ApiClient.accessToken() + '"'
+                                }
+                            })
+                            .then(response => {
+                                if (response.ok) return response.json();
+                                throw new Error('Network response was not ok.');
+                            })
+                            .then(data => {
+                                // Update URL input
+                                urlInput.value = ApiClient.serverAddress() + data.url;
+                                updatePreview();
+                                Dashboard.hideLoadingMsg();
+                            })
+                            .catch(error => {
+                                console.error('Upload error:', error);
+                                Dashboard.alert('Image upload failed. Please verify API controller is active.');
+                                Dashboard.hideLoadingMsg();
+                            });
+                        }
+
+
                         Dashboard.hideLoadingMsg();
                     });
                 },
@@ -629,7 +805,9 @@
                         'PreferLocalTrailers', 'ApplyLimitsToCustomIds', 'SeasonalSections',
                         'PreferLocalBackdrops', 'RandomizeThemeVideos', 'RandomizeLocalTrailers',
                         'IncludeWatchedContent', 'ShowPaginationDots', 'MaxParentalRating',
-                        'MaxDaysRecent', 'ExcludeSeasonalContent'
+                        'MaxDaysRecent', 'ExcludeSeasonalContent', 'HideArrowsOnMobile',
+                        'EnableCustomOverlay', 'CustomOverlayText', 'CustomOverlayImageUrl',
+                        'CustomOverlayStyle'
                     ];
 
                     keys.forEach(function (key) {
@@ -665,7 +843,9 @@
                         Name: 'New Season',
                         StartDay: 1, StartMonth: 1,
                         EndDay: 1, EndMonth: 1,
-                        MediaIds: ''
+                        MediaIds: '',
+                        OverlayText: '',
+                        OverlayImageUrl: ''
                     }, index);
                 },
 
@@ -726,6 +906,14 @@
                         '    <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 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 class="inputContainer" style="margin-top: 1em;">' +
+                        '    <input is="emby-input" type="text" class="emby-input section-overlay-text" style="width: 100%;" value="' + (data.OverlayText ? data.OverlayText.replace(/"/g, '&quot;') : '') + '" placeholder="Seasonal Custom Overlay Text (e.g. Oscars Time!)" />' +
+                        '    <div class="fieldDescription">Optional: Override the global custom overlay text during this season.</div>' +
+                        '</div>' + 
+                        '<div class="inputContainer">' +
+                        '    <input is="emby-input" type="text" class="emby-input section-overlay-image" style="width: 100%;" value="' + (data.OverlayImageUrl ? data.OverlayImageUrl.replace(/"/g, '&quot;') : '') + '" placeholder="Seasonal Custom Overlay Image URL" />' +
+                        '    <div class="fieldDescription">Optional: Override the global custom overlay image during this season. Overrides the text if provided.</div>' +
                         '</div>';
 
                     div.querySelector('.btn-remove').addEventListener('click', function () {
@@ -770,7 +958,9 @@
                             StartMonth: parseInt(el.querySelector('.start-month').value),
                             EndDay: parseInt(el.querySelector('.end-day').value),
                             EndMonth: parseInt(el.querySelector('.end-month').value),
-                            MediaIds: el.querySelector('.section-ids').value
+                            MediaIds: el.querySelector('.section-ids').value,
+                            OverlayText: el.querySelector('.section-overlay-text').value,
+                            OverlayImageUrl: el.querySelector('.section-overlay-image').value
                         });
                     });
                     return sections;

Jellyfin.Plugin.MediaBarEnhanced/Helpers/TransformationPatches.cs

@@ -18,7 +18,7 @@ namespace Jellyfin.Plugin.MediaBarEnhanced.Helpers
             try 
             {
                 // Safety Check: If plugin is disabled, do nothing
-                if (!MediaBarEnhancedPlugin.Instance.Configuration.IsEnabled)
+                if (MediaBarEnhancedPlugin.Instance?.Configuration?.IsEnabled != true)
                 {
                     return originalContents;
                 }

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.7.1.6</Version>
+    <Version>1.7.1.15</Version>
     <RepositoryUrl>https://github.com/CodeDevMLH/jellyfin-plugin-media-bar-enhanced</RepositoryUrl>
   </PropertyGroup>
 

Jellyfin.Plugin.MediaBarEnhanced/MediaBarEnhancedPlugin.cs

@@ -17,7 +17,6 @@ namespace Jellyfin.Plugin.MediaBarEnhanced
     {
         private readonly ScriptInjector _scriptInjector;
         private readonly ILoggerFactory _loggerFactory;
-        public IServiceProvider ServiceProvider { get; }
 
         /// <summary>
         /// Initializes a new instance of the <see cref="MediaBarEnhancedPlugin"/> class.

Jellyfin.Plugin.MediaBarEnhanced/Web/mediaBarEnhanced.css

@@ -354,13 +354,13 @@
   width: 100%;
   height: 100%;
   mask-image: linear-gradient(to top,
-      #fff0 2%,
-      rgb(0 0 0 / 0.5) 6%,
+      rgba(255, 255, 255, 0) 2%,
+      rgba(0, 0, 0, 0.5) 6%,
       #000000 8%);
   -webkit-mask-image: linear-gradient(to top,
-      #fff0 2%,
-      rgb(0 0 0 / 0.5) 6%,
-      #000000 8%);
+    rgba(255, 255, 255, 0) 2%,
+    rgba(0, 0, 0, 0.5) 6%,
+    #000000 8%);
 }
 
 .backdrop-container.full-width-video {
@@ -384,13 +384,13 @@
   border-radius: 5px;
   z-index: 3;
   mask-image: linear-gradient(to top,
-      #fff0 2%,
-      rgb(0 0 0 / 0.5) 6%,
-      #000000 8%);
+    rgba(255, 255, 255, 0) 2%,
+    rgba(0, 0, 0, 0.5) 6%,
+    #000000 8%);
   -webkit-mask-image: linear-gradient(to top,
-      #fff0 2%,
-      rgb(0 0 0 / 0.5) 6%,
-      #000000 8%);
+    rgba(255, 255, 255, 0) 2%,
+    rgba(0, 0, 0, 0.5) 6%,
+    #000000 8%);
 }
 
 .backdrop-overlay {
@@ -403,13 +403,13 @@
   border-radius: 5px;
   z-index: 4;
   mask-image: linear-gradient(to top,
-      #fff0 2%,
-      rgb(0 0 0 / 0.5) 4%,
-      #000000 6%);
+    rgba(255, 255, 255, 0) 2%,
+    rgba(0, 0, 0, 0.5) 4%,
+    #000000 6%);
   -webkit-mask-image: linear-gradient(to top,
-      #fff0 2%,
-      rgb(0 0 0 / 0.5) 4%,
-      #000000 6%);
+    rgba(255, 255, 255, 0) 2%,
+    rgba(0, 0, 0, 0.5) 4%,
+    #000000 6%);
 }
 
 .gradient-overlay {
@@ -424,13 +424,13 @@
       rgba(29, 29, 29, 0) 100%);
   z-index: 4;
   mask-image: linear-gradient(to top,
-      #fff0 2%,
-      rgb(0 0 0 / 0.5) 4%,
-      #000000 6%);
+    rgba(255, 255, 255, 0) 2%,
+    rgba(0, 0, 0, 0.5) 4%,
+    #000000 6%);
   -webkit-mask-image: linear-gradient(to top,
-      #fff0 2%,
-      rgb(0 0 0 / 0.5) 4%,
-      #000000 6%);
+    rgba(255, 255, 255, 0) 2%,
+    rgba(0, 0, 0, 0.5) 4%,
+    #000000 6%);
 }
 
 .gradient-overlay.full-width-video {
@@ -525,6 +525,8 @@
   font-family: "Archivo Narrow", sans-serif;
   font-size: 18px;
   white-space: nowrap;
+  background-color: rgb(255, 255, 255);
+  color: rgb(0, 0, 0);
   cursor: pointer;
   transition: all 0.3s ease;
   font-weight: 700;
@@ -535,6 +537,7 @@
 
 .detail-button {
   font-size: 18px;
+  background-color: rgb(255, 255, 255);
   color: rgb(0, 0, 0);
   border-radius: 50%;
   height: 50px;
@@ -547,6 +550,7 @@
 
 .favorite-button {
   font-size: 18px;
+  background-color: rgb(255, 255, 255);
   color: red;
   border-radius: 50%;
   height: 50px;
@@ -662,7 +666,7 @@
   display: flex;
   align-items: center;
   border-radius: 5px;
-  background: rgb(255 255 255 / 0.8);
+  background: rgba(255, 255, 255, 0.8);
   color: #000;
   border: none;
   font-weight: 600;
@@ -712,13 +716,13 @@
     object-position: center 20%;
     z-index: 3;
     mask-image: linear-gradient(to top,
-        #fff0 2%,
-        rgb(0 0 0 / 0.5) 6%,
-        #000000 8%);
+      rgba(255, 255, 255, 0) 2%,
+      rgba(0, 0, 0, 0.5) 6%,
+      #000000 8%);
     -webkit-mask-image: linear-gradient(to top,
-        #fff0 2%,
-        rgb(0 0 0 / 0.5) 6%,
-        #000000 8%);
+      rgba(255, 255, 255, 0) 2%,
+      rgba(0, 0, 0, 0.5) 6%,
+      #000000 8%);
   }
 
   .gradient-overlay {
@@ -727,17 +731,17 @@
     left: 0;
     width: 100%;
     height: 100%;
-    background: rgb(0 0 0 / 0.25);
+    background: rgba(0, 0, 0, 0.25);
     z-index: 4;
     pointer-events: none;
     mask-image: linear-gradient(to top,
-        #fff0 2%,
-        rgb(0 0 0 / 0.5) 6%,
-        #000000 8%);
+      rgba(255, 255, 255, 0) 2%,
+      rgba(0, 0, 0, 0.5) 6%,
+      #000000 8%);
     -webkit-mask-image: linear-gradient(to top,
-        #fff0 2%,
-        rgb(0 0 0 / 0.5) 6%,
-        #000000 8%);
+      rgba(255, 255, 255, 0) 2%,
+      rgba(0, 0, 0, 0.5) 6%,
+      #000000 8%);
   }
 
   .dots-container {
@@ -1008,7 +1012,7 @@
   margin: 0;
 }
 
-.layout-tv .backdrop-container{
+.layout-tv .backdrop-container {
   top: -5%;
 }
 
@@ -1016,14 +1020,136 @@
   .layout-tv .backdrop.animate {
     animation: none !important;
   }
-  
+
   .layout-tv .logo.animate {
     animation: none !important;
   }
-  
+
   .layout-tv .slide-counter,
   .layout-tv .dots-container {
     backdrop-filter: none;
     -webkit-backdrop-filter: none;
   }
 }
+/* Floating Custom Overlay Styling */
+.custom-overlay-container {
+  position: absolute;
+  top: 8vh;
+  left: 4vw;
+  z-index: 15;
+  display: flex;
+  align-items: center;
+  justify-content: flex-start;
+  pointer-events: none; /* Let clicks pass through to the slider */
+  animation: fadeInOverlay 1.5s ease-in-out forwards;
+}
+
+.custom-overlay-text {
+  font-family: "Archivo Narrow", sans-serif;
+  color: #fff;
+  font-size: 2.5rem;
+  font-weight: 700;
+  text-shadow: 2px 2px 8px rgba(0, 0, 0, 0.8), -1px -1px 4px rgba(0, 0, 0, 0.5);
+  margin: 0;
+  letter-spacing: 1px;
+}
+
+.custom-overlay-image {
+  max-width: 300px;
+  max-height: 120px;
+  object-fit: contain;
+  filter: drop-shadow(2px 4px 6px rgba(0,0,0,0.5));
+}
+
+@keyframes fadeInOverlay {
+  from {
+    opacity: 0;
+    transform: translateY(-10px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+/* Make it smaller on mobile portrait */
+@media only screen and (max-width: 767px) and (orientation: portrait) {
+  .custom-overlay-container {
+    top: 5vh;
+    left: 50%;
+    transform: translateX(-50%);
+    width: 90%;
+    justify-content: center;
+    text-align: center;
+  }
+  
+  .custom-overlay-text {
+    font-size: 1.8rem;
+  }
+  
+  .custom-overlay-image {
+    max-width: 200px;
+    max-height: 80px;
+  }
+
+  @keyframes fadeInOverlay {
+    from {
+      opacity: 0;
+      transform: translate(-50%, -10px);
+    }
+    to {
+      opacity: 1;
+      transform: translate(-50%, 0);
+    }
+  }
+}
+
+/* Custom Overlay Styles */
+.custom-overlay-style-Shadowed {
+  color: #fff;
+  text-shadow: 2px 2px 8px rgba(0, 0, 0, 0.9), -1px -1px 4px rgba(0, 0, 0, 0.8);
+}
+
+.custom-overlay-style-Frosted {
+  color: #fff;
+  background: rgba(0, 0, 0, 0.4);
+  backdrop-filter: blur(10px);
+  -webkit-backdrop-filter: blur(10px);
+  padding: 8px 24px;
+  border-radius: 50px;
+  border: 1px solid rgba(255, 255, 255, 0.2);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.5);
+  text-shadow: none; /* override default */
+}
+
+.custom-overlay-style-Cinematic {
+  background: linear-gradient(to right, #bf953f, #fcf6ba, #b38728, #fbf5b7, #aa771c);
+  -webkit-background-clip: text;
+  background-clip: text;
+  color: transparent;
+  text-shadow: none; /* override default */
+  filter: drop-shadow(0px 2px 8px rgba(255, 215, 0, 0.4)) drop-shadow(2px 2px 4px rgba(0,0,0,0.8));
+  animation: shineCinematic 4s linear infinite;
+  background-size: 200% auto;
+}
+
+@keyframes shineCinematic {
+  to {
+    background-position: 200% center;
+  }
+}
+
+.custom-overlay-style-Pulse {
+  color: #fff;
+  text-shadow: 2px 2px 8px rgba(0, 0, 0, 0.9), -1px -1px 4px rgba(0, 0, 0, 0.8);
+  animation: pulseOverlayText 3s ease-in-out infinite alternate;
+}
+
+@keyframes pulseOverlayText {
+  from {
+    transform: scale(1);
+  }
+  to {
+    transform: scale(1.05);
+  }
+}

Jellyfin.Plugin.MediaBarEnhanced/Web/mediaBarEnhanced.js

@@ -57,6 +57,11 @@ const CONFIG = {
   preferredVideoQuality: "Auto",
   enableKeyboardControls: true,
   alwaysShowArrows: false,
+  hideArrowsOnMobile: true,
+  enableCustomOverlay: false,
+  customOverlayText: "",
+  customOverlayImageUrl: "",
+  customOverlayStyle: "Shadowed",
   enableCustomMediaIds: true,
   enableSeasonalContent: false,
   customMediaIds: "",
@@ -748,7 +753,7 @@ const SlideUtils = {
     if (isYoutube && videoId) {
       const ytIframe = this.createElement('iframe', {
         id: 'modal-yt-player',
-        src: `https://www.youtube-nocookie.com/embed/${videoId}?enablejsapi=1&origin=${encodeURIComponent(window.location.origin)}`,
+        src: `https://www.youtube-nocookie.com/embed/${videoId}?autoplay=1&controls=1&iv_load_policy=3&rel=0&playsinline=1`,
         allow: 'autoplay; encrypted-media',
         style: 'width: 100%; height: 100%; border: none;',
         referrerpolicy: 'strict-origin-when-cross-origin',
@@ -758,20 +763,6 @@ const SlideUtils = {
       contentContainer.appendChild(ytIframe);
       overlay.append(closeButton, contentContainer);
       document.body.appendChild(overlay);
-
-      this.loadYouTubeIframeAPI().then(() => {
-        new YT.Player(ytIframe, {
-          playerVars: {
-            autoplay: 1,
-            controls: 1,
-            iv_load_policy: 3,
-            rel: 0,
-            playsinline: 1,
-            origin: window.location.origin,
-            enablejsapi: 1
-          }
-        });
-      });
     } else {
       const video = this.createElement('video', {
         src: url,
@@ -779,6 +770,7 @@ const SlideUtils = {
         autoplay: true,
         className: 'video-modal-player'
       });
+      video.setAttribute('playsinline', '');
       contentContainer.appendChild(video);
       overlay.append(closeButton, contentContainer);
       document.body.appendChild(overlay);
@@ -835,7 +827,7 @@ const LocalizationUtils = {
       }
     }
 
-    if (window.ApiClient && STATE.jellyfinData?.accessToken) {
+    if (window.ApiClient && STATE.jellyfinData && STATE.jellyfinData.accessToken) {
       try {
         const userId = window.ApiClient.getCurrentUserId();
         if (userId) {
@@ -845,7 +837,7 @@ const LocalizationUtils = {
           });
           if (userResponse.ok) {
             const userData = await userResponse.json();
-            if (userData.Configuration?.AudioLanguagePreference) {
+            if (userData.Configuration && userData.Configuration.AudioLanguagePreference) {
               locale = userData.Configuration.AudioLanguagePreference.toLowerCase();
             }
           }
@@ -855,7 +847,7 @@ const LocalizationUtils = {
       }
     }
 
-    if (!locale && window.ApiClient && STATE.jellyfinData?.accessToken) {
+    if (!locale && window.ApiClient && (STATE.jellyfinData && STATE.jellyfinData.accessToken)) {
       try {
         const configUrl = window.ApiClient.getUrl('System/Configuration');
         const configResponse = await fetch(configUrl, {
@@ -1030,7 +1022,7 @@ const LocalizationUtils = {
    */
   getLocalizedString(key, fallback, ...args) {
     const locale = this.cachedLocale || 'en-us';
-    let translated = this.translations[locale]?.[key] || fallback;
+    let translated = (this.translations[locale] && this.translations[locale][key]) || fallback;
 
     if (args.length > 0) {
       for (let i = 0; i < args.length; i++) {
@@ -1775,9 +1767,12 @@ const SlideCreator = {
       }
 
       const isLowPower = isLowPowerDevice();
+      const isIOSApp = /iPhone|iPad|iPod/i.test(navigator.userAgent);
+      const limitVideos = isLowPower || isIOSApp;
       const itemIndex = STATE.slideshow.itemIds ? STATE.slideshow.itemIds.indexOf(itemId) : -1;
       const isActiveSlide = itemIndex !== -1 && itemIndex === STATE.slideshow.currentSlideIndex;
-      const shouldCreateVideo = !isLowPower || isActiveSlide;
+      // Limit YouTube iframe bulk creation on low power devices OR iOS (which kills the WebProcess on OOM)
+      const shouldCreateVideo = !limitVideos || isActiveSlide;
 
       if (isYoutube && videoId && shouldCreateVideo) {
         isVideo = true;
@@ -1945,6 +1940,7 @@ const SlideCreator = {
         };
 
         videoAttributes.muted = "";
+        videoAttributes.playsinline = "";
 
         videoBackdrop = SlideUtils.createElement("video", videoAttributes);
         videoBackdrop.volume = 0.4;
@@ -2453,6 +2449,7 @@ const SlideshowManager = {
         previousVisibleSlide.classList.remove("active");
       }
 
+      void currentSlide.offsetWidth;
       currentSlide.classList.add("active");
 
       // Manage Video Playback: Stop others, Play current
@@ -2730,9 +2727,9 @@ const SlideshowManager = {
 
       const totalItems = STATE.slideshow.itemIds.length;
       let distance = Math.abs(index - currentIndex);
-      if (totalItems > keepRange * 2) {
-          distance = Math.min(distance, totalItems - distance);
-      }
+      
+      // Always calculate circular distance for slideshow
+      distance = Math.min(distance, totalItems - distance);
 
       if (distance > keepRange) {
         // Destroy video player if exists
@@ -2802,7 +2799,7 @@ const SlideshowManager = {
 
     if (currentItemId) {
       const currentSlide = document.querySelector(`.slide[data-item-id="${currentItemId}"]`);
-      const video = currentSlide?.querySelector('video');
+      const video = currentSlide ? currentSlide.querySelector('video') : null;
 
       if (video) {
         video.muted = STATE.slideshow.isMuted;
@@ -2962,7 +2959,7 @@ const SlideshowManager = {
     if (!currentSlide) return;
 
     // YouTube player: just resume, don't reload
-    const ytPlayer = STATE.slideshow.videoPlayers?.[currentItemId];
+    const ytPlayer = (STATE.slideshow.videoPlayers && STATE.slideshow.videoPlayers[currentItemId]) ? STATE.slideshow.videoPlayers[currentItemId] : undefined;
     if (ytPlayer && typeof ytPlayer.playVideo === 'function') {
       if (STATE.slideshow.isMuted) {
         if (typeof ytPlayer.mute === 'function') ytPlayer.mute();
@@ -3469,6 +3466,10 @@ const initArrowNavigation = () => {
   container.appendChild(muteButton);
 
   const showArrows = () => {
+    if (CONFIG.hideArrowsOnMobile && window.matchMedia("only screen and (max-width: 768px)").matches) {
+        return; // disable arrow display on mobile
+    }
+
     leftArrow.style.display = "block";
     rightArrow.style.display = "block";
 
@@ -3780,6 +3781,88 @@ const slidesInit = async () => {
     return;
   }
   
+  const renderCustomOverlay = () => {
+    let activeOverlayText = CONFIG.customOverlayText;
+    let activeOverlayImage = CONFIG.customOverlayImageUrl;
+    let isSeasonOverride = false;
+
+    if (CONFIG.enableSeasonalContent && CONFIG.seasonalSections) {
+      try {
+        const sections = JSON.parse(CONFIG.seasonalSections || "[]");
+        const now = new Date();
+        const currentMonth = now.getMonth() + 1;
+        const currentDay = now.getDate();
+
+        for (const section of sections) {
+          const startMonth = parseInt(section.StartMonth);
+          const startDay = parseInt(section.StartDay);
+          const endMonth = parseInt(section.EndMonth);
+          const endDay = parseInt(section.EndDay);
+
+          let isActive = false;
+          if (startMonth === endMonth) {
+            if (currentMonth === startMonth && currentDay >= startDay && currentDay <= endDay) {
+              isActive = true;
+            }
+          } else if (startMonth < endMonth) {
+            if (currentMonth > startMonth && currentMonth < endMonth) {
+              isActive = true;
+            } else if (currentMonth === startMonth && currentDay >= startDay) {
+              isActive = true;
+            } else if (currentMonth === endMonth && currentDay <= endDay) {
+              isActive = true;
+            }
+          } else { // Wraps around year
+            if (currentMonth > startMonth || currentMonth < endMonth) {
+              isActive = true;
+            } else if (currentMonth === startMonth && currentDay >= startDay) {
+              isActive = true;
+            } else if (currentMonth === endMonth && currentDay <= endDay) {
+              isActive = true;
+            }
+          }
+
+          if (isActive) {
+            if (section.OverlayText || section.OverlayImageUrl) {
+                isSeasonOverride = true;
+                if (section.OverlayText) activeOverlayText = section.OverlayText;
+                if (section.OverlayImageUrl) activeOverlayImage = section.OverlayImageUrl;
+            }
+            break;
+          }
+        }
+      } catch (e) {
+        console.error("🎬 Media Bar:", "Error parsing seasonal sections for overlay:", e);
+      }
+    }
+
+    if (!CONFIG.enableCustomOverlay && !isSeasonOverride) {
+      return; 
+    }
+
+    if (!activeOverlayText && !activeOverlayImage) return;
+
+    const overlayContainer = document.createElement("div");
+    overlayContainer.className = "custom-overlay-container";
+
+    if (activeOverlayImage) {
+      const img = document.createElement("img");
+      img.className = "custom-overlay-image";
+      img.src = activeOverlayImage;
+      overlayContainer.appendChild(img);
+    } else if (activeOverlayText) {
+      const p = document.createElement("p");
+      p.className = `custom-overlay-text custom-overlay-style-${CONFIG.customOverlayStyle || 'Shadowed'}`;
+      p.textContent = activeOverlayText;
+      overlayContainer.appendChild(p);
+    }
+
+    const slidesContainer = document.getElementById("slides-container");
+    if (slidesContainer) {
+      slidesContainer.appendChild(overlayContainer);
+    }
+  };
+  
   if (CONFIG.enableClientSideSettings) {
       MediaBarEnhancedSettingsManager.init();
       const isClientSideEnabled = MediaBarEnhancedSettingsManager.getSetting('enabled', true);
@@ -3878,6 +3961,8 @@ const slidesInit = async () => {
 
     initArrowNavigation();
 
+    renderCustomOverlay();
+
     await SlideshowManager.loadSlideshowData();
 
     SlideshowManager.initTouchEvents();

manifest.json

@@ -9,12 +9,12 @@
     "imageUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/raw/branch/main/logo.png",
     "versions": [
       {
-        "version": "1.7.1.6",
-        "changelog": "- feat: add option to disable pagination dots/counter\n- feat: add exclude seasonal content from random fetching option\n- fix button issue on mobile when using ElegantFin Theme",
+        "version": "1.7.1.15",
+        "changelog": "feat: add custom text/image overlay option\n- feat: add option to disable pagination dots/counter\n- feat: add exclude seasonal content from random fetching option\n- Add hide arrows on mobile option \n- fix button issue on mobile when using ElegantFin Theme",
         "targetAbi": "10.11.0.0",
-        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.7.1.6/Jellyfin.Plugin.MediaBarEnhanced.zip",
-        "checksum": "d334b961ac8c6a527dba490b5a926c40",
-        "timestamp": "2026-03-08T18:33:15Z"
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.7.1.15/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "fbdf488b7f0575b290fd7fcfde31f295",
+        "timestamp": "2026-03-09T03:03:01Z"
       },
       {
         "version": "1.7.0.14",