Media Bar Enhanced Configuration

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.

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.

Priority (If Both Are Set)

What should be displayed if you have both an Image and Text configured?

Global Overlay Text

Text to display on the overlay (e.g. "Movie Night!").

Global Overlay Image URL

Absolute URL to an image to display on the overlay.

Or Upload Local Image

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.

Styles

Overlay Style

Choose the visual styling animation for your custom text.

Image Style

Choose a visual effect to apply to your overlay image.

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.

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.