Skip to content

Installation

Required Plugins for User Page

For regular users to access SmartLists from their home screen, the following plugins are required:

  1. Plugin Pages - Enables custom pages in the Jellyfin sidebar

  2. File Transformation - Required dependency for Plugin Pages

Not Required for Admin Access

These plugins are only needed if you want regular users to access SmartLists from their home screen. Administrators can always access SmartLists through Dashboard → My Plugins → SmartLists without these plugins.

If these plugins are not installed, the SmartLists plugin will still function normally, but the user-facing page will not be available.

From Repository

  1. Add the Repository:

    • Go to Dashboard → Plugins → Manage Repositories)
    • Click New Repository
    • Enter a repository name of your choosing and the following repository URL: 
      https://raw.githubusercontent.com/jyourstone/jellyfin-plugin-manifest/main/manifest.json
    • Click Save

  2. Optional: Install Plugins for user page access:

    • First, install File Transformation plugin from its repository
    • Then, install Plugin Pages plugin (depends on File Transformation)
    • Installation order matters: File Transformation must be installed before Plugin Pages
    • See repository URLs in the "Required Plugins for User Page" section above
    • Restart Jellyfin after installing both plugins

  3. Install SmartLists Plugin:

    • Go to Dashboard → Plugins → All/Available
    • Click SmartLists in the list of available plugins
    • Click Install
    • Restart Jellyfin after the plugin installation completes

Jellyfin 10.11 vs. Jellyfin 12

Jellyfin 10.11 users

New releases now target Jellyfin 12 only. If you're on Jellyfin 10.11, the newest version you'll be offered is v12.0.1.0 — that's expected, not a bug. It's the last release built for 10.11, and it will keep working normally; it just won't receive newer features. To get newer versions, upgrade Jellyfin itself to version 12.

After upgrading Jellyfin from 10.11 to 12

Update the SmartLists plugin after upgrading your Jellyfin server. If the plugin shows "Not supported" right after the server upgrade, that's just the old 10.11 build still installed — updating to the newest version replaces it with the Jellyfin 12 build and fixes it.

Manual Installation

Download the latest release from the Releases page and extract it to a subfolder in your Jellyfin plugins directory (for example /config/plugins/smartlists) and restart Jellyfin.

Try RC Releases (Unstable)

Want to test the latest features before they're officially released? You can try release candidate (RC) versions using the unstable manifest:

https://raw.githubusercontent.com/jyourstone/jellyfin-plugin-manifest/unstable/manifest.json

RC Releases

RC releases are pre-release versions that may contain bugs or incomplete features. Use at your own risk and consider backing up your smart list configurations before upgrading.

Documentation for RC releases

The documentation is published twice, because RC builds often include features and options that do not exist in stable yet:

If you installed from the unstable manifest above, use the RC site — otherwise the pages may describe options your build does not have, or omit ones it does.