From d737bc9422567fa40777a118afda68fadd5de162 Mon Sep 17 00:00:00 2001
From: CodeDevMLH <145071728+CodeDevMLH@users.noreply.github.com>
Date: Thu, 8 Jan 2026 02:59:21 +0100
Subject: [PATCH] Update configPage.html to clarify custom media ID
 functionality and input instructions

---
 .../Configuration/configPage.html                  | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/Jellyfin.Plugin.MediaBarEnhanced/Configuration/configPage.html b/Jellyfin.Plugin.MediaBarEnhanced/Configuration/configPage.html
index 2f29b75..fe21ab7 100644
--- a/Jellyfin.Plugin.MediaBarEnhanced/Configuration/configPage.html
+++ b/Jellyfin.Plugin.MediaBarEnhanced/Configuration/configPage.html
@@ -93,8 +93,9 @@
                                     name="EnableCustomMediaIds" />
                                 <span>Enable Custom Media IDs</span>
                             </label>
-                            <div class="fieldDescription">If enabled, the slideshow will ONLY show the items listed
-                                below.</div>
+                            <div class="fieldDescription">If enabled, the slideshow will try to show the items listed
+                                below. If the list is empty, default behavior (random items) is used. Disable this
+                                to temporarily ignore your custom list without deleting it.</div>
                         </div>
                         <div class="checkboxContainer checkboxContainer-withDescription">
                             <label>
@@ -113,7 +114,10 @@
                                 style="width: 100%; height: 150px; font-family: monospace;"></textarea>
                             <div class="fieldDescription" id="customMediaIdsDesc">Enter the IDs of the items you want to
                                 show in the slideshow.
-                                You can separate them by comma or new line.</div>
+                                You can separate them by comma or new line.
+                                You can also add a description after the ID using any separator like space, pipe
+                                (|) or dash (-) (e.g. <code>ID | Description</code>).
+                                Note: The separator MUST NOT be a hex character (0-9, a-f).</div>
                             <div class="fieldDescription" id="seasonalMediaIdsDesc" style="display: none;">
                                 <b>Seasonal Mode Enabled:</b> Define lines with date ranges (Format: DD.MM-DD.MM |
                                 <i>name</i> | <i>IDs</i>).<br>
@@ -127,8 +131,8 @@
                                 Example:
                                 <code>https://your-jellyfin-url/web/#/details?id=<b style="color:red;">your-item-id</b>&serverId=your-server-id</code><br><br>
                                 You can also insert a name of a collection or playlist to fetch the IDs of all items in
-                                it (will take the first hit.<br>Note: there is currently no feedback if the name resolution
-                                succeeded, you will have to look if the bar displays the correct items.).
+                                it (will take the first hit.<br>Note: there is currently no feedback if the name
+                                resolution succeeded, you will have to look if the bar displays the correct items.).
                             </p>
                         </div>
                     </div>