README.md

April 24, 2026 ยท View on GitHub

Jellyfin Smart Collections Plugin

Jellyfin Smart Collections Plugin is a plugin that automatically creates Smart Collections based on selected Tags associated with your library

What is it?

You can configure Jellyfin Smart Collections Plugin with a list of Tags on movies and series in your Jellyfin server.

For example, "The Long Kiss Goodnight" gets a "christmas" tag applied when you fetch metadata

Now that you know that your movie has been tagged with "christmas", you can set up a Smart Collection for the christmas tag in the plugin settings

The result after running the task is that a Collection is created for each Tag you configured in the plugin setup. All movies and series matching the tag are included in the Smart Collection. The Smart Collection is kept up to date any time the task runs, removing items that were un-tagged and adding items that were tagged since the last time the plugin ran.

Install Process

  1. In Jellyfin, go to Dashboard -> Plugins -> Catalog -> Gear Icon (upper left) add and a repository.
  2. Set the Repository name to @johnpc (Smart Collections)
  3. Set the Repository URL to https://raw.githubusercontent.com/johnpc/jellyfin-plugin-smart-collections/refs/heads/main/manifest.json
  4. Click "Save"
  5. Go to Catalog and search for Smart Collections
  6. Click on it and install
  7. Restart Jellyfin

User Guide

  1. To set it up, visit Dashboard -> Plugins -> My Plugins -> Smart Collections -> Settings
  2. Configure your tags that you want converted to Smart Collections as a comma-seperated list
  3. Choose "Save"
  4. Choose "Sync Smart Collections For Tags"
  5. Viola! Your Smart Collections now exist.
  6. Note: The Smart Collections Sync task is also available in your Scheduled Tasks section.

Build Process

  1. Clone or download this repository
  2. Ensure you have .NET Core SDK setup and installed
  3. Build plugin with following command.
make build
  1. Manifest url is at https://raw.githubusercontent.com/johnpc/jellyfin-plugin-smart-collections/refs/heads/main/manifest.json

Deploy Process

Releases are fully automated. Just merge to main and GitHub Actions will:

  • Auto-bump the patch version from the latest tag
  • Build the plugin with the correct version
  • Create a GitHub release with the zip + manifest
  • Update the manifest on main so users get the new version automatically