Skip to content

Jellyfin SmartLists Plugin

Logo
Total GitHub Downloads GitHub Issues or Pull Requests Build and Release Jellyfin Version

Official documentation for the Jellyfin SmartLists plugin.

SmartLists creates rule-based playlists and collections that refresh automatically as your Jellyfin library changes. The plugin is maintained in the open on GitHub and the documentation in this site tracks the current released behavior of the project.

Requires Jellyfin version 10.11.0 and newer.

What SmartLists Does

  • Builds playlists and collections from rules instead of manual curation
  • Refreshes lists automatically when library content or playback state changes
  • Supports movies, shows, episodes, music, photos, books, and more
  • Lets administrators and regular users manage lists through the Jellyfin web UI
  • Supports external sources such as IMDb, TMDB, Trakt, MDBList, and Letterboxd

Features

  • Modern Web Interface - A full-featured UI to create, manage and view status for smart playlists and collections
  • External Lists - Populate lists from MDBList, IMDb, Trakt, and TMDB
  • User Selection - Choose which users should own a playlist or collection with an intuitive dropdown
  • Flexible Rules - Build simple or complex rules with an intuitive builder
  • Automatic Updates - Playlists and collections refresh automatically on library updates, playback status changes, or via scheduled tasks
  • Refresh Status & Statistics - Monitor ongoing refresh operations with real-time progress, view refresh history, and track statistics for all your lists
  • Media Types - Works with all Jellyfin media types
  • End User Config Page - Let regular users manage their own smart lists from the home screen (requires Plugin Pages and File Transformation plugins)

Screenshots

Supported Media Types

SmartLists works with all media types supported by Jellyfin:

  • Movie - Individual movie files
  • Series - TV shows as a whole (can only be used when creating a Collection)
  • Season - TV show seasons (can only be used when creating a Collection)
  • Episode - Individual TV show episodes
  • Audio (Music) - Individual music tracks and songs
  • Album (Music) - Entire music albums (can only be used when creating a Collection)
  • Music Video - Music video files
  • Video - Personal home videos and recordings and extras (trailers, interviews etc.)
  • Photo (Home Photo) - Personal photos and images
  • Book - eBooks, comics, and other readable content
  • Audiobook - Spoken word audio books

Quick Start

  1. Install the Plugin: See Installation Guide
  2. Access SmartLists:
    • Regular Users: Click "SmartLists" in your home screen sidebar (requires administrator to configure allowed users in Dashboard → My Plugins → SmartLists → User Selection)
    • Administrators: Go to Dashboard → Plugins → SmartLists
  3. Create Your First List: Use the "Create List" tab
  4. Example: Create a playlist or collection for "Unwatched Action Movies" with:
    • Media type: "Movie"
    • Genre contains "Action"
    • Playback Status = Unplayed

Maintenance Notes

This project uses AI-assisted development, but the plugin and docs are reviewed, tested, and maintained through the public GitHub repository. If you find something unclear or incorrect, please open an issue or discussion so it can be fixed.