# Media Bar Enhanced Configuration

## 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.
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. Only visible if trailer is not set as backdrop or if no trailer is available.

## Custom Media IDs

Enable Custom Media IDs
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.
Enable Seasonal Content Mode
Enable this to define time-based lists in the field below.
Media/Collection/Playlist IDs (Newline or Comma separated)
Enter the IDs of the items you want to show in the slideshow. You can separate them by new line or comma.
Manual Trailer Override: You can specify a YouTube URL for an item by adding it in brackets:
`e.g. ID DESCRIPTION [https://youtu.be/...]` or `ID [https://youtu.be/...] DESCRIPTION`
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).
Seasonal Mode Enabled: Define lines with date ranges (Format: DD.MM-DD.MM | name | IDs).
Example:
`20.10-31.10 | Halloween | ID1, ID2 [https://youtu.be/...]`
`01.12-26.12 | Christmas | ID3, ID4`
Only lines matching the current date will be used. If no line matches, it will try to use random items.

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.).

## 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.
Use SponsorBlock
Skip intro/outro segments in YouTube trailers.
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.)
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)
Always Show Arrows
If enabled, navigation arrows will always be visible instead of only on hover.
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 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 images to preload.
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.