SpotlightTrailer/README.md

SpotlightTrailer - Featured Content Bar

Thanks to SethBacon & BobHasNoSoul & MakD & tedhinklater for their talents and work

Main Differences in this fork

• automatically skip outros/endcards and intros on trailers using SponsorBlock API
• show the featured bar only at the main page, hide it in favorites/requests tab
• set txt list name for eg. switch between diffrent seasonal versions
• small ui style fixes
• html, css and javascript in seperate files
• no hard coded api key needed

Testet on Jellyfin 10.10.6

Table of Contents

• SpotlightTrailer - Featured Content Bar
  • Main Differences in this fork
  • Table of Contents
  • Configuration Parameters
  • Installation
  • Uninstall
  • How to feature specific content in the bar
• Desktop View
• Mobile View (Landscape / Portrait)

---

Configuration Parameters

The following configuration parameters are used to customize the behavior and appearance of the slideshow. You can adjust them at the beginning of script.js:

• title:
  The title of the slideshow. Set this to a descriptive name for your slideshow. To be done - Should be shown above featured bar slide

• listFileName:
  The name of the file containing the list of movie or series IDs. Ensure this file exists in the correct location.

• moviesSeriesBoth:
  Specifies the type of content to display:

  • 1 for movies only,
  • 2 for series only,
  • 3 for both.

  Default is 3

• shuffleInterval:
  Time interval (in milliseconds) between slides, unless a trailer is playing. Adjust for desired slide transition speed.

• useTrailers:
  Enable (true) or disable (false) the display of trailers in the slideshow.

• setRandomMovie:
  Enable (true) or disable (false) random selection of movies or series from the list. Default is true

• showOnOtherPages:
  Set to true to show the slideshow on additional pages, such as "Favorites" or "Requests." Default is false.

• disableTrailerControls:
  Set to true to hide trailer controls; false enables user control over the trailer. Default is true

• setMutedHover:
  Set to false to disable unmuting the video on hover Default mute setting for trailers on hover over entire slideshow element: Default is true

• umuteOnHover:
  Unmute video when hovered over (true) or keep muted (false). Default is true

• unmutedVolume:
  Volume level (0–100) when unmuted. Default is 20

• useSponsorBlock:
  Enable (true) or disable (false) the use of SponsorBlock data for skipping segments (outros, intros) in trailers. Default is true

• skipIntro:
  Enable (true) or disable (false) to skip the intro segment of the trailer. Default is true

• plotMaxLength:
  Maximum number of characters for plot descriptions. Adjust as needed.

• trailerMaxLength:
  Maximum duration (in milliseconds) of trailers. Set to 0 to disable trailer length limitation. Could be used instead of SponsorBlock, but SponsorBlock is recommended

• isMuted:
  Default mute state of videos (true for muted, false for unmuted).

By adjusting these parameters, you can fine-tune the slideshow's behavior and appearance to suit your needs.

Installation

Tip

Take a look at CodeDevMLH/Jellyfin-Mods-Automated-Script

1. Download spotlight.html, script.js and styles.css

2. Modify script.js like explained above if necessary.

3. Go to your jellyfin-web folder and create a folder named featured and drop spotlight.html, script.js and styles.css in that folder

4. Important: Use Notepad++ for this
   In the jellyfin-web folder, open the file home-html.RANDOMSTRINGHERE.chunk.js

5. Ctrl+F and search for data-backdroptype="movie,series,book">

6. Paste this after the >

<style> .featurediframe {width: 95vw; height: 24em; display: block; border: 0; margin: -1em auto 0;} @media (min-width: 2100px) {.featurediframe {height: 33em;}} @media (max-width: 1599px) {.featurediframe {margin-top: 1.2em;}} @media (max-width: 800px) {.featurediframe {margin-top: 0.8em; height: 25em;}} </style> <iframe class="featurediframe" src="/web/featured/spotlight.html"></iframe>

7. Save the file.

8. Empty your browser's cached web content (Ctrl+F5 or empty it from your browser's Cookies and Site Data settings section)

9. That's it.

Uninstall

Simply delete Step 7's snippet added to home-html.chunk.js then refresh your browser's cache. You can, but not have to delete the featured folder.

How to feature specific content in the bar

By default, the bar will feature content at random as long as it is available to the current user and no list.txt is available or if it is empty below line 1.

To preselect content, place a list.txt in the featured folder and paste the ID of each piece of content to be featured (IDs can be found in the address bar).

IMPORTANT If you use List.txt to preselect content and a User has an Age Rating limit on their account (U, PG etc) make sure you add content for them to see too, or it will just be blank (content above their Age Limit is hidden to them)

Desktop View

Mobile View (Landscape / Portrait)