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.

Requires Jellyfin version 10.11.0 and newer.

Features

  • 🚀 Modern Jellyfin Support - Built for newer Jellyfin versions with improved compatibility
  • 🎨 Modern Web Interface - A full-featured UI to create, edit, view and delete smart playlists and collections
  • ✏️ Edit Lists - Modify existing smart playlists and collections directly from the UI
  • 👥 Multi-User Playlists - Create playlists for multiple users, with each user getting their own personalized version based on their playback data
  • 🎯 Flexible Rules - Build simple or complex rules with an intuitive builder
  • 🔄 Automatic Updates - Playlists and collections refresh automatically on library updates or via scheduled tasks
  • 📦 Export/Import - Export all lists to a ZIP file for backup or transfer between Jellyfin instances
  • 🎵 Media Types - Works with all Jellyfin media types

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 Plugin Settings: Go to Dashboard → My Plugins → SmartLists
  3. Create Your First List: Use the "Create List" tab
  4. Example: Create a playlist or collection for "Unwatched Action Movies" with:
  5. Media type: "Movie"
  6. Genre contains "Action"
  7. Playback Status = Unplayed

For more detailed instructions, see the Quick Start Guide.

Overview

This plugin creates smart playlists and collections that automatically update based on rules you define, such as:

  • Unplayed movies from specific genres
  • Recently added series or episodes
  • Next unwatched episodes for "Continue Watching" playlists
  • High-rated content from certain years
  • Music from specific artists or albums
  • Tagged content like "Christmas", "Kids", or "Documentaries"
  • And much more!

The plugin features a modern web-based interface for easy list management - no technical knowledge required.