selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
Jellyfin-Auto-Collections logo

Self-host Jellyfin-Auto-Collections

Auto-create Jellyfin collections from IMDb, Letterboxd

BetaOpen SourceMIT
Updated5 months ago
LanguagePython
Setup difficultyModerate
Stars
286
Requires
Jellyfin
Docker
ghcr.io/ghomashudson/jellyfin-auto-collections
Install with Docker Compose
Terminal output showing collection creation from a list source

What is Jellyfin-Auto-Collections?

Jellyfin Auto Collections is a Python utility for Jellyfin users who want to automatically populate their media library with curated collections from popular online lists. It connects to a self-hosted Jellyfin instance via the API and fetches movie and show lists from sources including IMDb charts and lists, Letterboxd lists, Trakt trending and popular lists, mdblist, the TSPDT 1000 greatest films list, Steven Lu's Popular Movies, The Criterion Channel, Listmania, BFI, and Jellyfin's own API queries. It can also sync tags from Radarr and Sonarr, and integrate with Overseerr or Jellyseerr for request-based collections. The tool runs on a configurable cron schedule (default daily at midnight) or can be executed manually. It is deployed via Docker Compose using the ghcr.io/ghomashudson/jellyfin-auto-collections image, or run directly on bare metal with Python 3. Collections are created or updated in Jellyfin, with optional poster generation for collections lacking artwork. The project is MIT-licensed and actively maintained, though it has no formal versioned releases — the Docker image tracks the latest master branch.

Should you self-host Jellyfin-Auto-Collections?

Jellyfin-Auto-Collections scores 46/100 on selfhost.directory (how scoring works) and ranks #78 of 118 in Media Server. It has 286 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Jellyfin (88/100, 58 740 stars). It scores higher overall, so compare the two before you pick. See Jellyfin-Auto-Collections vs Jellyfin side by side.

Features

  • Automatic collection creation
  • Bare metal Python deployment
  • Multiple list source plugins
  • Overseerr/Jellyseerr integration
  • Poster generation
  • Scheduled runs via cron

Jellyfin-Auto-Collections README

How to install Jellyfin-Auto-Collections

Install Jellyfin-Auto-Collections with Docker Compose

Environment variables
CRONTAB, TZ, JELLYFIN_SERVER_URL, JELLYFIN_API_KEY, JELLYFIN_USER_ID

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 restart: unless-stopped

Requires a config.yaml file mapped to /app/config

How to configure Jellyfin-Auto-Collections

  • CRONTABCron schedule for automatic runs (e.g., '0 0 * * *' for daily at midnight). Blank to disable scheduling.

    Cron schedule for automatic runs (e.g., '0 0 * * *' for daily at midnight). Blank to disable scheduling.

    values: Cron expression

  • JELLYFIN_API_KEYJellyfin API key for authentication.

    Jellyfin API key for authentication.

    values: API key string

  • JELLYFIN_SERVER_URLhttps://www.jellyfin.example.comURL of the Jellyfin instance.

    URL of the Jellyfin instance.

    values: URL

  • JELLYFIN_USER_IDJellyfin user ID (found in the user profile URL).

    Jellyfin user ID (found in the user profile URL).

    values: User ID string

  • LOG_LEVELINFOLogging level for the application.

    Logging level for the application.

    values: DEBUG, INFO, WARNING, ERROR

  • TZTimezone for the cron schedule.

    Timezone for the cron schedule.

    values: IANA timezone (e.g., America/New_York)

More in Media Server

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…