Jellyfin SmartLists Plugin

Create smart, rule-based playlists and collections in Jellyfin — for movies, shows, music, or anything your library holds.

A single genre rule takes seconds; stack rules into groups and you can express almost anything. Either way, they keep themselves up to date. The plugin 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
• External Lists - Populate lists from MDBList, IMDb, Letterboxd, Trakt, TMDB, ListenBrainz, and Scrob — trending charts, watchlists, top lists, music playlists, and more
• 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)
• Templates - Start from built-in templates - TV channel round-robin, Continue Watching, external-list imports, album roulette, and more
• And more - View the documentation to see all features

🚀 Quick Start

1. Install the Plugin: See installation instructions
2. Access Plugin Settings: Click on "SmartLists" in the main sidebar under "Plugins" (or via 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:
   • Media type: "Movie"
   • Genre contains "Action"
   • Is Played = False

⚙️ Configuration Interface

SmartLists features a modern web-based configuration interface with four main tabs:

📖 Documentation

View Full Documentation →

Complete guide with installation instructions, detailed field descriptions, operators, examples, advanced configuration, and more!

💬 Support & Feedback

• Bug Reports & Feature Requests: Please use the Issues tab to report bugs or suggest new features.
• Community Support & General Help: For support questions or general help, please use Discussions.

📦 How to Install

1. Add this repository URL to your Jellyfin plugin catalog:

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

2. Install the plugin
3. Restart Jellyfin

Complete installation instructions can be found in the documentation.

🙏 Credits

This project is based on the original SmartPlaylist plugin created by ankenyr. You can find the original repository here. All credit for the foundational work and the core idea goes to him.

⚠️ Disclaimer

Much of the recent work on this project has been AI-assisted, but the repository, releases, and documentation are reviewed and maintained by the project owner. If you run into a bug or spot something inaccurate, please open an issue or discussion.