## Media Bar Enhanced

${Help}

## Main Plugin Settings

Enable Media Bar Enhanced Plugin
Enable or disable the entire plugin functionality.
Enable Trailer Backdrops
Show trailers as background if available.
Adds a mute/unmute and pause/play button to control the video in the right top corner.
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 remote and local trailers.
Wait For Trailer To End
Delay slide transition until trailer finishes.
Enable Trailer On Mobile
Allow video playback on mobile devices.
Show Trailer Button
Display a button to open trailer in modal. Button only visible if trailer is not set as backdrop.

## Custom Media IDs

Enable Custom Media IDs
If enabled, the slideshow will show the items listed below as the default content. If the list is empty, random items from your library are used.
Apply Limits to Custom IDs
If enabled, the Max Items limit (Advanced → Content Limits) will also apply to Custom Media IDs and Collections. By default, custom lists are not limited.
Default Media/Collection/Playlist IDs (Newline or Comma-separated)
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.
Manual Trailer/Video Override: You can specify a YouTube URL OR a Jellyfin Item ID (e.g. for a Theme Video) for an item by adding it in brackets:
`e.g. ID DESCRIPTION [https://youtu.be/...]` or `ID [JellyfinItemId] DESCRIPTION`.
Methods:

- YouTube URL: Play a remote trailer from YouTube.
- Jellyfin Item ID (GUID): Play the video of another library item (e.g. a Theme Video or Backdrop Video) using the native player.

You can also add a description after the ID using any separator like space, pipe (|) or dash (-):
e.g. `ID DESCRIPTION` or `ID | DESCRIPTION`
Note: If using a Collection Name (instead of an ID) combined with a description, you MUST use the pipe (|) separator.
Note: The separator MUST NOT be a hex character (0-9, a-f).

You can find the IDs of your items in the URL of the item page in the web interface.
Example: `https://your-jellyfin-url/web/#/details?id=your-item-id&serverId=your-server-id`
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.
Note: There is currently no feedback if the name resolution succeeded, you will have to look if the bar displays the correct items).

## Seasonal Content

Enable Seasonal Content
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 or random selection are used as fallback.
Exclude Seasonal Content from Random Lists
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.
info
Define seasonal rules to automatically select a selection of items based on the date. Rules are evaluated from top to bottom. The first matching rule wins.

## Custom Slideshow Overlay

Inject a custom text or floating image over the slideshow. This can be overridden by specific Seasonal Sections in the Custom Filters tab.

Enable Custom Overlay
If enabled, the text or image below will hover over the slideshow globally.
Overlay Style
Choose the visual styling animation for your custom text.
Global Overlay Text
Text to display on the overlay (e.g. "Movie Night!"). Leave blank to use an image instead.

### Global Overlay Image

Global Overlay Image URL
Absolute URL to an image to display on the overlay. If provided, this overrides the text above.
Or Upload Local Image
cloud_upload Drag and drop an image here, or click to select
Uploading an image will securely save it to the server and automatically update the URL field above.

## Features

Enable Slide Animations
Enable the zooming-in effect on background images when a new slide is shown (does not affect trailer backdrops). Attention: This may cause performance issues on weaker client hardware.
Enable Client-Side Settings
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.
Randomize Backdrop Video
If enabled, a random video from the backdrops/theme videos will be selected instead of the first one (if multiple exist).
Randomize Local Trailer
If enabled, a random local trailer will be selected instead of the first one (if multiple exist).
Use SponsorBlock
Skip intro/outro segments in YouTube trailers (if data is available).
Preferred YouTube Quality
"Auto" selects Maximum if screen width > 1920px, otherwise 1080p.
Start Muted
Start trailer video playback muted. (Known issue: In the Android/IOS app, backdrop trailers are always muted.)
Warning: Disabling this may cause autoplay to fail on certain browsers due to strict autoplay policies.
Full Width Video
Stretch video to full width. Very nice on desktops, on mobile devices only the middle of the video is visible.
Disable to get the full aspect ratio on mobile devices. (looks bad on desktops)
Enable Loading Screen
Show a loading screen while the slideshow initializes. (You may have to reload the page twice (after changing this setting) to take effect)
Always Show Arrow Navigation Buttons
Force the UI arrow navigation buttons to always be visible instead of only when hovered.
Hide Arrows on Mobile
Completely disable the navigation arrows on mobile devices (since swiping is available).
Enable Keyboard Controls
Enable keyboard shortcuts (Arrows left/right (change slide), Space (pause), M (mute/unmute)) for the slideshow.

## Time Settings

Leave a setting blank to use the default value.

Shuffle Interval (ms)
Time in milliseconds between changing slides.
Retry Interval (ms)
Time in milliseconds to wait before retrying failed operations.
Loading Check Interval (ms)
Frequency of checking wether the login screen or home screen has loaded (in milliseconds).
Fade Transition Duration (ms)
Duration in milliseconds of the transition between slides.
Min Swipe Distance (px)
Minimum distance in pixels for a swipe to be registered (for mobile).

## Content Sorting and Filtering

Sort By
Sort items by the selected criteria.
Sort Order
Sort items in Ascending or Descending order.
Note: Sorting settings apply to both Server content and Custom IDs. 'Original' preserves Custom List order.
Max Parental Rating (Age Limit)
Items exceeding this age rating will not be shown. Leave blank or set to 0 for no limit. Examples: 12, 16, 18.
Max Days Recent
Only show items added in the last X days. Leave blank or set to 0 for no limit. Example: 30.
Include Watched Content
If enabled, watched content will be included in the random selection results.

## Content Limits

Leave a setting blank to use the default value.

Total Max Items
Maximum total items to fetch (for all content types combined).
Max Movies
Maximum movies to include in slideshow (for random selection).
Max TV Shows
Maximum TV shows to include in slideshow (for random selection).
Preload Count
Number of slides to preload.
Show Pagination Dots/Counter
Show or hide the pagination dots/counter navigation at the bottom of the slideshow.
Max Pagination Dots
Maximum number of dots to show in navigation. If the number will be exceeded, the dots will "turn" into a counter style (e.g. 1/100). Set to 0 to enable counter style directly.
Max Plot Length
Maximum characters for the plot summary.
info
All changes require a page refresh (ctrl + r or F5) after saving for changes to take effect.
If old settings persist, please force clear browser cache.