Skip to content

Jellyfin SmartLists Plugin

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

Create smart, rule-based playlists and collections in Jellyfin.

This plugin allows you to create dynamic playlists and collections based on a set of rules, which will automatically update as your library changes. It features a modern web-based interface for easy list management - no technical knowledge required.

Requires Jellyfin version 10.11.0 and newer.

Features

  • Modern Web Interface - A full-featured UI to create, manage and view status for smart playlists and collections
  • 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)
  • Episode - Individual TV show episodes
  • Audio (Music) - Music tracks and albums
  • Music Video - Music video files
  • Video (Home Video) - Personal home videos and recordings
  • 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