Plugin ‐ Jellyfin API - ghomasHudson/Jellyfin-Auto-Collections GitHub Wiki

The jellyfin_api plugin allows for collections to be automatically created based on queryies to the jellyfin API.

This allows for collections such as "Mystery movies before 1960" etc. The Jellyfin API documentation lists all the possible parameters you can use.

Use list_name and list_desc to set the collection name and description to something more human readable.

Adding includeItemTypes: ["Movie","Series"] filters for only Movies and TV Shows and prevents collections from including individual episodes of shows.

Examples

A "Movies of the Day" collection, which showcases three different, highly-rated movies each time the script runs.

plugins:
  ...
  jellyfin_api:
    enabled: true
    clear_collection: true
    list_ids:
      - minCriticRating: ["9"]
        limit: ["3"]
        sortBy: ["Random"]
        includeItemTypes: ["Movie"]
        list_name: "Movies of the day"
        list_desc: "3 highly-rated movies"

By tag and genre, e.g. Film-noir, mystery movies:

plugins:
  ...
  jellyfin_api:
    enabled: true
    list_ids:
      - tags: ["film noir"]
        genres: ["Mystery"]
        list_name: "Film-Noir Mysteries"

By person, e.g. Wes Anderson Movies:

plugins:
  ...
  jellyfin_api:
    enabled: true
    list_ids:
      - person: ["Wes Anderson"] 
        includeItemTypes: ["Movie"]        
        list_name: "Wes Anderson Collection"
        list_desc: "Movies where Wes Anderson features."

By a free-text search:

plugins:
  ...
  jellyfin_api:
    enabled: true
    list_ids:
      - searchTerm: "Asterix"
        list_name: "Asterix & Obelix"

By studio:

plugins:
  ...
  jellyfin_api:
    enabled: true
    list_ids:
      - studios: ["Marvel Studios","Marvel Entertainment"]
        list_name: "Studio: Marvel"
        includeItemTypes: ["Movie"]

By year:

plugins:
  ...
  jellyfin_api:
    enabled: true
    list_ids:
      - years: [2025]
        list_name: "2025 Movies"
        includeItemTypes: ["Movie"]