Jellyfin-Auto-Collections

Jellyfin-Auto-Collections

Docker app from LubricantJam's Repository

Automatically create and manage collections in Jellyfin based on configurable rules.

Requirements

Before starting, download the example config file from the GitHub repository and place it in the config path you specify. You will need to obtain a Jellyfin API key from your Jellyfin server dashboard (Dashboard > API Keys). The application runs on a schedule to update collections automatically.
Overview
Automatically create and manage collections in Jellyfin based on configurable rules. Runs on a schedule to keep your collections up to date.

Jellyfin Auto Collections

A tool to automatically make and update jellyfin collections based on internet lists such as IMDb and letterboxd. Also syncs with Overseerr/Jellyseerr.

Getting collections list...

found /r/TrueFilm Canon (1000 films) 015dee24c79dacfa80300afb7577fc37
************************************************

Can't find A Trip to the Moon
Can't find The Birth of a Nation
Can't find Intolerance: Love's Struggle Throughout the Ages
Can't find A Man There Was
Can't find The Cabinet of Dr. Caligari
Added Big Buck Bunny cc561c8b1d5da3a080cdb61ebe44d1a7
Added Big Buck Bunny 2 0515533b716e8fe76d3b630f9b9b6d51
Can't find Nosferatu
Can't find Dr. Mabuse, the Gambler
Can't find Häxan
Added Big Buck Bunny 3 9a6b8002ef8f12a0611e92f5104d8b8e
Can't find Sherlock, Jr.
Can't find Greed
Can't find The Last Laugh
Can't find Battleship Potemkin
Added Big Buck Bunny 5 98690cc73413b12593988687ee737a27
Can't find Ménilmontant
...

pic-selected-220609-1405-13

Supported List Sources

  • IMDB Charts - e.g. Top 250 Movies, Top Box Office
  • IMDB Lists - e.g. Top 100 Greatest Movie of All time
  • Letterboxd - lists (username/list/slug), watchlists (username/watchlist), and liked films (username/likes/films). Public lists need no login. To sync your own private list, use its usual list ID and set both plugins.letterboxd.username and plugins.letterboxd.password via environment variables as shown in config.yaml.example. For Docker, pass those variables into the container. The resulting collection is visible according to Jellyfin’s permissions, not Letterboxd’s privacy settings.
  • mdblist - e.g. Top Movies of the week
  • They Shoot Pictures, Don't They - The 1,000 Greatest Films
  • Trakt - e.g. Popular Movies. See the Wiki for instructions.
  • Steven Lu Popular movies
  • The Criterion Channel
  • Listmania
  • BFI
  • Jellyfin API Queries - Make lists which match a particular filter from the Jellyfin API. See the Wiki for some usage examples.
  • Radarr/Sonarr - Make collections from your *arr tags.

Please feel free to send pull requests with more!

Usage

First, copy config.yaml.example to config.yaml and change the values for your specific jellyfin instance.

Bare Metal

Make sure you have Python 3 and pip installed.

Install the requirements with pip install -r requirements.txt.

If you enable either IMDb plugin, install its Chromium browser with python -m playwright install --with-deps --only-shell chromium (the Docker image includes it).

Then run python main.py.

Docker

The easiest way to get going is to use the provided docker-compose.yml configuration. Whatever directory you end up mapping to the /app/config directory needs to contain your updated config.yaml file:

services:
  jellyfin-auto-collections:
    image: ghcr.io/ghomashudson/jellyfin-auto-collections:latest
    container_name: jellyfin-auto-collections
    environment:
      - CRONTAB=0 0 * * *
      - TZ=America/New_York
      - JELLYFIN_SERVER_URL=https://www.jellyfin.example.com
      - JELLYFIN_API_KEY=1a1111aa1a1a1aaaa11a11aa111aaa11
      - JELLYFIN_USER_ID=2b2222bb2b2b2bbbb22b22bb222bbb22
    volumes:
      - ${CONFIG_DIR}/jellyfin-auto-collections/config:/app/config

Configuration Options

Environment Variable Description
JELLYFIN_SERVER_URL The URL of your Jellyfin instance
JELLYFIN_API_KEY Generated API Key
JELLYFIN_USER_ID UserID from the URL of your Profile in Jellyfin
CRONTAB The interval the scripts will be run on in crontab syntax. Blank to disable scheduling (make sure you're not using the docker restart policy).
TZ Timezone the interval will be run in. No effect if scheduling is disabled.

Categories

Related apps

Explore more like this

Explore all

Links

Details

Repository
ghcr.io/ghomashudson/jellyfin-auto-collections:latest
Last Updated2026-11-22
First Seen2025-10-26

Runtime arguments

Network
host
Shell
bash
Privileged
false

Template configuration

Crontab ScheduleVariable

Cron expression for scheduling collection updates (default: daily at midnight)

Target
CRONTAB
Default
0 0 * * *
Value
0 0 * * *
TimezoneVariable

Timezone for the container

Target
TZ
Default
Europe/London
Value
Europe/London
Jellyfin Server URLVariable

URL of your Jellyfin server (e.g., https://jellyfin.example.com or http://localhost:8096)

Target
JELLYFIN_SERVER_URL
Jellyfin API KeyVariable

API key from your Jellyfin server (Dashboard > API Keys)

Target
JELLYFIN_API_KEY
Jellyfin User IDVariable

ID of the Jellyfin user account to use

Target
JELLYFIN_USER_ID
Config PathPathrw

Path where config.yaml file will be stored

Target
/app/config
Value
/mnt/user/appdata/jellyfin-auto-collections