ElegantFin

1. Open Dashboard from Administration tab in Settings.
2. From the side bar, select the Branding tab if you are on Jellyfin 10.11 or above.
3. Scroll down to find Custom CSS code box.
4. Paste the custom css in Custom CSS code box.
5. Click save

1. Open Display tab in Settings.
2. Scroll down to find Custom CSS code box.
3. Paste the custom css in Custom CSS code box.
4. Click save.

• Read more about this experimental add-on here

• Note: this customisation is not needed on Jellyfin 10.11.X anymore
• On older Jellyfin versions, to enable the background wallpaper on the login screen, first tick the 'Enable the splash screen' option in your Jellyfin Dashboard below the Custom CSS Box.
• Second, copy and paste the following code at the end in Custom CSS box but don't save yet.

  :root {
      --loginPageBgUrl: url("<YOUR-JELLYFIN-SERVER-ADDRESS>/Branding/Splashscreen?format=webp&foregroundLayer=1&quality=33&width=3840&height=2160&blur=2");
  }

• Third, replace <YOUR-JELLYFIN-SERVER-ADDRESS> with your Jellyfin server address, for example, http://192.168.0.1:8096.
• Don't forget the correct http or https in your domain.
• You can also modify the parameters, for example blur size or the resolution, according to your liking.
• Once done, save and refresh your apps and webpages.

• To enable 'Mark Played' and 'Add to Favorites' buttons that show up at the bottom right corner of cards while hovering, copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.

  :root {
      --extraCardButtonsVisibility: block;
  }

• To hide the three-dot button that shows up next to these buttons, also include --menuButtonVisibility: none; in :root{}
• To undo these changes, simply remove this code block or switch between block and none.

• To bring the mini play button to the center of cards, copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.

  :root{
    --overlayPlayButtonPosition: 50%;
  }

• To undo this change, simply remove this code block or replace 50% with 2.8em.

Recording.2025-08-14.121536.mp4

• To disable the shine on cards that shows when hovering over them on desktop, copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.

  :root{
    --cardHoverEffect: none;
  }

• To undo this change, simply remove this code block or replace none with "".

• To enable text labels under the media library cards, copy and paste the following code at the end in Custom CSS box, click save and finally refresh your app/webpage.

  :root{
  --libraryLabelVisibility: block;
  }

• To undo this change, simply remove this code block or replace block with none.

• ElegantFin does not support any plugins by default, so to to add external support for this plugin, copy and paste the following code right after the main import in Custom CSS box, click save and finally refresh your app/webpage.

  @import url("https://cdn.jsdelivr.net/gh/lscambo13/ElegantFin@main/Theme/assets/add-ons/media-bar-plugin-support-latest-min.css");

• To undo this change, simply remove this code block.

Recording.2025-08-08.125121.mp4

• You can switch between these using --appBarHeight.
• Use 5em to enable the fading app bar (seamless) (default);
• Or, use 4.6em to get the solid app bar (cleaner with border)

  :root{
    /* example */
    --appBarHeight: 4.6em;
  }

• To undo this change, simply remove this code block.

• Check out the the theme Playground page for different color themes.
• You can also experiment and share your own take there if you wish.

• You can adjust their scaling --resumeCardScale.
• Use any values over 1.0 to make them bigger.

  :root{
    --resumeCardScale: 1.25;
  }

• To undo this change, simply remove this code block or set the value back to 1.

• Check the version number at the bottom in the Settings screen.
• It should be something like ElegantFin v26.YY.ZZ.

• If the Settings footer shows an old version, it means that you are still using an old cache.
• Once that cache is updated, the new version will be loaded automatically.
• There are multiple ways to clear the cache depending on your OS, smartphone or TV. Look online if you don't know.
• On the web version, you can force a hard refresh of the page using CTRL + F5.
• On apps, try signing out and back in again. OR in case of Jellyfin Media Player on windows, you might need to delete the cache folder.

• JMP is based on Qt 5.x which uses a very outdated web engine. It does not support many new CSS features, so it is unsupported.
• Jellyfin Desktop is the new official client moving forward. It seems to be in testing right now. Use it for better compatibility or use the web app instead.

• As of version 0.18.11, the official Jellyfin app on the AndroidTVs does not support css themes, but the Android mobile phone app supports them. The WebOS version of the app seems to be based on the mobile phone version, so it supports the theme just fine.

• It seems that modern Material Icons which this theme uses are not compatible on some WebOS TVs. There is a huge similar thread about this.
• This bug can be fixed by using the older icons, so I have implemented the following workaround to bring back older, supported icons.
• Simply add the following code at the end in Custom CSS box and save, then refresh your apps and webpages:

  :root{
    --iconPack: 'Material Icons';
  }

• First check here whether a similar issue has been reported already. If it exists, upvote and comment there to let me know.
• Alternatively, create a new issue here.

• 🤷