https://github.com/johnpc/jellyfin-plugin-smart-collections
https://github.com/johnpc/jellyfin-plugin-smart-collections
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/johnpc/jellyfin-plugin-smart-collections
- Owner: johnpc
- License: mit
- Created: 2025-03-06T19:32:06.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-23T02:05:22.000Z (about 1 year ago)
- Last Synced: 2025-10-10T15:19:25.502Z (8 months ago)
- Language: C#
- Size: 64.5 KB
- Stars: 77
- Watchers: 4
- Forks: 2
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Jellyfin Smart Collections Plugin
Jellyfin Smart Collections Plugin is a plugin that automatically creates Smart Collections based on selected Tags associated with your library
## What is it?
You can configure Jellyfin Smart Collections Plugin with a list of Tags on movies and series in your Jellyfin server.
For example, "The Long Kiss Goodnight" gets a "christmas" tag applied when you fetch metadata
Now that you know that your movie has been tagged with "christmas", you can set up a Smart Collection for the christmas tag in the plugin settings
The result after running the task is that a Collection is created for each Tag you configured in the plugin setup. All movies and series matching the tag are included in the Smart Collection. The Smart Collection is kept up to date any time the task runs, removing items that were un-tagged and adding items that were tagged since the last time the plugin ran.
## Install Process
1. In Jellyfin, go to `Dashboard -> Plugins -> Catalog -> Gear Icon (upper left)` add and a repository.
1. Set the Repository name to @johnpc (Smart Collections)
1. Set the Repository URL to https://raw.githubusercontent.com/johnpc/jellyfin-plugin-smart-collections/refs/heads/main/manifest.json
1. Click "Save"
1. Go to Catalog and search for Smart Collections
1. Click on it and install
1. Restart Jellyfin
## User Guide
1. To set it up, visit `Dashboard -> Plugins -> My Plugins -> Smart Collections -> Settings`
1. Configure your tags that you want converted to Smart Collections as a comma-seperated list
1. Choose "Save"
1. Choose "Sync Smart Collections For Tags"
1. Viola! Your Smart Collections now exist.
1. Note: The Smart Collections Sync task is also available in your Scheduled Tasks section.
## Build Process
1. Clone or download this repository
2. Ensure you have .NET Core SDK setup and installed
3. Build plugin with following command.
```sh
make build
```
6. Manifest url is at https://raw.githubusercontent.com/johnpc/jellyfin-plugin-smart-collections/refs/heads/main/manifest.json
## Deploy Process
The deploy process is automated via GitHub Actions:
1. Create and push a new tag:
```bash
git tag 0.0.0.X
git push origin 0.0.0.X
```
2. GitHub Actions will automatically:
- Build the plugin
- Create a zip file
- Calculate the MD5 checksum
- Generate a manifest.json for this version
- Create a GitHub release with both files
3. Update the repository manifest:
```bash
./generate_manifest.sh
git add manifest.json
git commit -m "Update manifest with version 0.0.0.X"
git push
```
The `generate_manifest.sh` script aggregates all release manifests into a single manifest.json file that users can reference for plugin installation.