iceshadow/jellyfinupdateposter

Jellyfin封面图片管理工具

镜像概述

本镜像是一个基于Python开发的工具，专门用于帮助Jellyfin服务器用户组织和更新媒体库的封面图片，以提升媒体内容的浏览体验和视觉一致性。

核心功能与特性

• 封面组织：自动整理Jellyfin媒体库中的封面图片，优化文件存储结构
• 封面更新：定期检查并更新媒体封面，确保展示内容最新
• 轻量级设计：基于Python构建，资源占用低，运行高效
• 无缝集成：与Jellyfin服务器兼容，可直接对接媒体库目录

使用场景与适用范围

• 适用于Jellyfin媒体服务器用户，需要统一管理媒体封面
• 媒体库规模较大，手动管理封面效率低下的场景
• 希望保持媒体库视觉统一性的个人或家庭用户
• 需要自动化更新媒体元数据及封面的应用场景

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name jellyfin-cover-manager \
  -v /path/to/jellyfin/media:/media \
  -v /path/to/config:/config \
  --restart unless-stopped \
  [镜像名称]

参数说明

• -v /path/to/jellyfin/media:/media：挂载Jellyfin媒体库目录，工具将在此目录中管理封面
• -v /path/to/config:/config：挂载配置目录，用于存储工具配置文件
• --restart unless-stopped：设置容器自动重启策略

配置文件说明

配置文件（默认位于/config/config.json）可配置以下参数：

• update_interval：封面更新间隔（单位：小时），默认值：24
• cover_size：封面图片尺寸，默认值：500x500
• media_types：需要处理的媒体类型，可选值："movie", "tv", "music"，默认包含所有类型

注意事项

• 确保挂载的媒体目录具有读写权限
• 首次运行时工具会自动生成默认配置文件，可根据实际需求修改
• 建议定期备份配置文件，避免设置丢失