- C# 75.1%
- JavaScript 20.6%
- HTML 4.1%
- CSS 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
e13de5aa19
On Jellyfin 12, MaxHeight is version-aware: an item is excluded when any of its alternate versions is taller than the bound. The per-item rule reads the primary version only, so a 1080p primary with a 2160p alternate was dropped from Resolution = 1080p lists before evaluation. Push down MinHeight only (version-aware MinHeight only widens the candidate set). LessThan/LessThanOrEqual now stay per-item. Fixes #546 Co-Authored-By: Claude Opus 5.5 <[email protected]> |
||
| .agents/skills | ||
| .claude/skills | ||
| .github | ||
| dev | ||
| docs | ||
| images | ||
| Jellyfin.Plugin.SmartLists | ||
| Jellyfin.Plugin.SmartLists.Tests | ||
| .cctop-ignore | ||
| .gitignore | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| CONTRIBUTING.md | ||
| Jellyfin.Plugin.SmartLists.sln | ||
| LICENSE | ||
| README.md | ||
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 12. Jellyfin 10.11 servers stay on v12.0.1.0, the last release built for them.
✨ 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
- Install the Plugin: See installation instructions
- Access Plugin Settings: Click on "SmartLists" in the main sidebar under "Plugins" (or via Dashboard → My Plugins → SmartLists)
- Create Your First List: Use the "Create List" tab
- 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
- Add this repository URL to your Jellyfin plugin catalog:
https://raw.githubusercontent.com/jyourstone/jellyfin-plugin-manifest/main/manifest.json
- Install the plugin
- 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.