Jellyfin Plugin Skin Manager

danieladovprayag17tashifkhanCTalvioaccusitivejenslysnichobiTriangleGuy6644

Jellyfin Skin Manager is a plugin that helps you to download and install skins

taflix Skins#

This fork lists Abyss, Catppuccin Mocha, Latte, Frappe, Macchiato, and Netflix. The build embeds skins-taflix.json in the DLL. Rebuild after editing the list. The settings page loads its controller and catalogue from Jellyfin, without jQuery, a Google Fonts API key, or a browser request to GitHub.

Choosing a skin updates branding.CustomCss, saves the plugin config, and opens Home with the new skin. Set Skin reapplies the selected skin. Dashboard never loads Branding CSS, so the skin only shows outside it.

Jellyfin 12 caches Branding CSS in IndexedDB and reuses it for a minute after a reload. The page deletes that cache entry before it reloads. Other browsers pick up the new skin on their first reload after the minute is up.

Other branding settings stay intact. Loading and saving failures clear the spinner and display a message. Load failures also offer Retry.

Netflix is a full layout skin that ships inside the plugin as taflix-netflix.css. Jellyfin serves it at /web/ConfigurationPage?name=taflix-netflix.css, so it needs no outside host apart from the Bebas Neue font used for the wordmark. Bump the v= value in skins-taflix.json after editing the file so browsers fetch the new copy.

Build with the .NET 9 SDK:

sh
dotnet publish Jellyfin.Plugin.SkinManager -c Release -o out

This build was checked on Jellyfin 12.3. Back up the installed DLL and server configuration before replacing the DLL. Restart the Jellyfin container after installation. Theme CSS still loads from the hosts named in the catalogue.

Jellyfin Skin Manager Plugin

Part of the Jellyfin Project

Jellyfin Skin Manager is a plugin that helps you to download and install skins;

Install Process#

From Repository#

  1. In jellyfin, go to dashboard -> plugins -> Repositories -> add and paste this link:
text
https://raw.githubusercontent.com/danieladov/JellyfinPluginManifest/master/manifest.json
  1. Go to Catalog and search for Skin Manager
  2. Click on it and install
  3. Restart Jellyfin

From .zip file#

  1. Download the .zip file from release page.
  2. Extract it and place the .dll file in a folder called plugins/SkinManager under the program data directory or inside the portable install directory.
  3. Restart Jellyfin.

User Guide#

  1. Go to Plugins, click on Skin Manager.
  2. Select the skin you want to install.
  3. Click set skin.

Build Process#

  1. Clone or download this repository
  2. Ensure you have .NET Core SDK setup and installed
  3. Build plugin with following command.
sh
dotnet publish --configuration Release --output bin
  1. Place the resulting .dll file in a folder called plugins/SkinManager under the program data directory or inside the portable install directory

Using with reverse proxy#

When using the Nginx Reverse proxy config from the Jellyfin docs the theme might not work by default. (If you are using the subpath config, you can ignore all this.)

Because the config includes Content-Security-Policy which reduces risk of XSS, you need to add the URL from the skin repo and the fonts to the list of allowed external sources.

For example to use Kaleidochromic you need to do CTalvio/Kaleidochromic

JSON#

Skin Properties#

  • name //The name of the skin

  • author //The author of the skin

  • defaultCss //The base css of the skin

  • options //An array of options that will modified the skin

    • Options Properties#

    • type //the type of the input (checkBox, number, select, colorPicker)
    • name // the name of the option
    • description // the description of the option
    • css //The css code that will modified the skin $ symbols in this code will be replaced by the value selected by the user (in number, select and color picer)

    Some option have custom properties:

    • number properties#

      • default //Default value
      • step //step of the input
    • selector properties#

      • selections //Array of options
        • selections properties#

          • name // name of the option
          • value // value of the option