jellyfin-library-poster

镜像概述和主要用途

jellyfin-library-poster是一款为Jellyfin/Emby媒体服务器设计的媒体库封面自动生成工具。它能根据媒体库中的海报（默认选取最新9张，若无时间信息则随机选择）定时生成媒体库封面，并自动上传更新至服务器，解决手动制作封面的繁琐问题，有效提升媒体库的视觉展示效果。

核心功能和特性

主题色智能提取与适配

• 基于媒体库第一张海报提取主题色，最多提取10种常见颜色
• 通过HSL颜色空间判断颜色是否适合作为背景，自动跳过过暗或过亮的颜色
• 若所有提取颜色均不合适，系统将随机生成一个HSL颜色，且控制在合适的色相、饱和度和明度范围内

渐变遮罩生成

• 创建从左到右的渐变遮罩，左侧深色过渡至右侧浅色，为前置的电影海报提供良好衬托，增强视觉层次感

使用场景和适用范围

适用于所有使用Jellyfin或Emby媒体服务器的用户，尤其适合媒体库内容频繁更新、需要自动维护封面美观度的场景。无论是个人家庭媒体中心还是小型媒体服务，均可通过该工具实现媒体库封面的自动化、个性化管理。

使用方法和配置说明

Docker运行

基本命令

docker run \
  --name jellyfin-library-poster \
  -v "./config:/app/config" \
  -v "./poster:/app/poster" \
  -v "./output:/app/output" \
  -v "./logs:/app/logs" \
  -v "./myfont:/app/myfont" \
  evanqu/jellyfin-library-poster:latest

挂载目录说明

• /app/config：存放配置文件config.json（必填，需手动创建并配置）
• /app/poster：存放下载的海报（可选）
• /app/output：存放生成的媒体库封面（可选）
• /app/logs：存放日志文件（可选）
• /app/myfont：存放自定义字体文件（可选，需配合配置文件调整）

docker-compose运行

docker-compose.yml文件

services:
  jellyfin-library-poster:
    image: evanqu/jellyfin-library-poster:latest
    container_name: jellyfin-library-poster
    volumes:
      - ./config:/app/config
      - ./poster:/app/poster
      - ./output:/app/output
      - ./logs:/app/logs
      - ./myfont:/app/myfont

启动命令

docker-compose down && docker-compose pull && docker-compose up -d

源码运行（可选）

• Python版本要求：3.13.3
• 运行步骤：

  pip install -r requirements.txt
  python main.py
  

配置文件说明

config.json是项目的核心配置文件，用于设置Jellyfin/Emby服务器连接信息及媒体库海报生成规则。需在/app/config目录下创建该文件，并根据实际需求修改配置。

注意事项

1. 确保base_url、user_name和password配置正确，以正常连接服务器
2. exclude_update_library中列出的媒体库将不会自动更新海报
3. JSON文件需严格遵循格式要求，若配置未生效，可通过JSON在线解析格式化验证工具检查格式错误

完整配置示例

{
  "jellyfin": [
    {
      "server_name": "MyJellyfin",
      "server_type": "jellyfin",
      "base_url": "[***]",
      "user_name": "user",
      "password": "pass",
      "update_poster": false
    },
    {
      "base_url": "[***]",
      "user_name": "user",
      "password": "pass",
      "update_poster": false
    }
  ],
  "cron": "0 1 * * *",
  "exclude_update_library": ["Short", "Playlists", "合集"],
  "style_config": [
    {
      "style_name": "style1",
      "style_ch_font": "字体名带后缀",
      "style_eng_font": "字体名带后缀"
    }
  ],
  "template_mapping": [
    {
      "library_name": "Anime",
      "library_ch_name": "动漫",
      "library_eng_name": "ANIME",
      "poster_sort": "DateLastContentAdded"
    },
    {
      "library_name": "Classic TV",
      "library_ch_name": "电视剧",
      "library_eng_name": "TV",
      "poster_sort": "Random"
    },
    {
      "library_name": "Movie",
      "library_ch_name": "电影",
      "library_eng_name": "MOVIE",
      "poster_sort": "DateCreated"
    },
    {
      "library_name": "Documentary",
      "library_ch_name": "纪录片",
      "library_eng_name": "DOC"
    },
    {
      "library_name": "合集",
      "library_ch_name": "合集",
      "library_eng_name": "COLLECTIONS"
    },
    {
      "library_name": "Hot Movie",
      "library_ch_name": "正在热映",
      "library_eng_name": "HOT MOVIE"
    },
    {
      "library_name": "Hot TV",
      "library_ch_name": "正在热播",
      "library_eng_name": "HOT TV",
      "poster_sort": "DateLastContentAdded"
    },
    {
      "library_name": "Short",
      "library_ch_name": "短剧",
      "library_eng_name": "SHORT"
    },
    {
      "library_name": "TEST TV",
      "library_ch_name": "测试电视",
      "library_eng_name": "TEST TV"
    }
  ]
}

配置节点说明

jellyfin节点：服务器配置

用于配置Jellyfin/Emby服务器连接信息，支持多服务器配置。

cron节点：定时任务

设置自动生成封面的定时任务时间，遵循标准Cron表达式格式（分钟 小时 日 月 星期）。示例："0 1 * * *"表示每天凌晨1点执行任务。

exclude_update_library节点：排除更新的媒体库

数组类型，列出不需要自动更新海报的媒体库名称，例如：["Short", "Playlists", "合集"]。

style_config节点：海报样式配置

用于配置海报字体样式，目前仅支持style1一种样式。

template_mapping节点：媒体库模板映射

为每个媒体库配置生成封面的显示名称和海报排序方式。

最近更新

更新日期

• 2025-04-28

问题修复

• 修复Emby随机排序方式无效的问题

效果图

运行日志

!运行日志

海报示例

!动漫 !电视剧 !纪录片 !正在热映 !正在热播 !电影