Jellyfin Collection (JFC) is a powerful, Kometa-compatible collection manager designed specifically for Jellyfin. It automatically creates and maintains media collections by fetching trending, popular, and curated content from TMDb, Trakt, and other sources.
If you're migrating from Plex and miss Kometa (formerly Plex Meta Manager), JFC brings the same YAML-based configuration to Jellyfin with additional features like AI-generated posters using OpenAI and seamless Sonarr/Radarr integration to automatically request missing media.
- Kometa YAML Compatibility - Use your existing Plex Meta Manager/Kometa configurations
- Jellyfin Native - Creates and manages collections directly in Jellyfin
- Multiple Providers - TMDb, Trakt, IMDb, and Arr taglist sources
- Sonarr/Radarr Integration - Automatically request missing media
- AI Poster Generation - Generate unique collection posters using OpenAI
- Rich Discord Notifications - Detailed notifications with poster images
- Scheduled Runs - Daily collection sync + monthly poster regeneration
- Docker Ready - Multi-platform images (amd64/arm64)
# Pull the image
docker pull ghcr.io/4lx69/jellyfin-collection:latest
# Or use docker-compose
docker-compose up -dSee Installation Guide for detailed setup instructions.
# Clone the repository
git clone https://github.com/4lx69/jellyfin-collection.git
cd jellyfin-collection
# Install dependencies
pip install -e .
# Run
jfc run --config ./config| Document | Description |
|---|---|
| Installation Guide | Step-by-step installation for Docker and manual setup |
| Configuration Guide | Complete configuration reference |
| Kometa Migration | Migrate from Kometa/Plex Meta Manager |
| AI Poster Generation | Setup and customize AI-generated posters |
| API Reference | Technical documentation and architecture |
JFC uses a dual configuration system for flexibility:
config.yml- Main configuration (portable, versionable).env- Secrets and overrides only
| Variable | Description |
|---|---|
JELLYFIN_API_KEY |
Jellyfin API key |
TMDB_API_KEY |
TMDb API key (get one here) |
| Service | Variable | Description |
|---|---|---|
| Radarr | RADARR_API_KEY |
Auto-request missing movies |
| Sonarr | SONARR_API_KEY |
Auto-request missing series |
| Trakt | TRAKT_CLIENT_ID, TRAKT_CLIENT_SECRET |
Trakt lists and charts |
| OpenAI | OPENAI_API_KEY |
AI poster generation |
All other settings are in config/config.yml:
settings:
jellyfin:
url: http://jellyfin:8096
tmdb:
language: fr
region: FR
openai:
enabled: true
missing_only: true
scheduler:
collections_cron: "0 17 * * *"
timezone: Europe/Paris
libraries:
Films:
collection_files:
- file: Films.ymlSee Configuration Guide for full reference.
# Run collection sync
jfc run
# Run specific library/collection
jfc run --library Films --collection "Trending Movies"
# Force poster regeneration
jfc run --force-posters
# Dry run (preview changes)
jfc run --dry-run
# Start scheduler daemon
jfc schedule
# Validate configuration
jfc validate
# List all collections
jfc list-collections
# Test service connections
jfc test-connections
# Generate a single poster
jfc generate-poster "My Collection" --category FILMS --library FilmsThe scheduler runs two jobs:
| Job | Default Schedule | Description |
|---|---|---|
| Collection Sync | Daily at 3am | Sync all collections |
| Poster Regeneration | 1st of month at 4am | Regenerate all AI posters |
Configure via environment variables:
SCHEDULER_COLLECTIONS_CRON=0 3 * * * # Daily at 3am
SCHEDULER_POSTERS_CRON=0 4 1 * * # 1st of month at 4am
SCHEDULER_RUN_ON_START=true # Sync on container start
SCHEDULER_TIMEZONE=Europe/ParisAdditional useful flags:
SCHEDULER_RUN_ALL_ON_START=false # Run all collections at startup
MATCHER_PRELOAD_LIMIT=50000 # Max preloaded items per library| Builder | Status | Description |
|---|---|---|
tmdb_trending_weekly |
Supported | TMDb weekly trending |
tmdb_trending_daily |
Supported | TMDb daily trending |
tmdb_popular |
Supported | TMDb popular movies/shows |
tmdb_discover |
Supported | TMDb discover with filters |
tmdb_list |
Supported | TMDb custom lists by ID/string/URL |
trakt_trending |
Supported | Trakt trending |
trakt_popular |
Supported | Trakt popular |
trakt_chart |
Supported | Trakt charts (watched, etc.) |
trakt_list |
Supported | Trakt custom lists |
imdb_chart |
Supported | IMDb charts (top, boxoffice, moviemeter, tvmeter) |
imdb_list |
Supported | IMDb user lists (ls...) |
radarr_taglist |
Supported | Build movie collections from Radarr tags |
sonarr_taglist |
Supported | Build series collections from Sonarr tags |
plex_search |
Supported | Jellyfin library search (Genres, year, year.gte, year.lte, limit) |
mdblist_list |
Planned | MDBList lists (planned) |
jellyfin-collection/
├── src/jfc/ # Source code
│ ├── cli.py # CLI commands
│ ├── core/ # Configuration, logging, scheduler
│ ├── clients/ # API clients (Jellyfin, TMDb, etc.)
│ ├── models/ # Data models
│ ├── parsers/ # Kometa YAML parser
│ └── services/ # Business logic
├── config/ # Kometa YAML configurations
├── docs/ # Documentation
├── tests/ # Unit tests
└── docker-compose.yml # Docker setup
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
MIT License
Copyright (c) 2025-2026 4lx69
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
See the LICENSE file for full details.
4lx69 - GitHub
If you find Jellyfin Collection useful, consider supporting the project: