collinheist/titlecardmaker Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

TitleCardMaker

概述

TitleCardMaker 是一个用Python编写的程序和Docker容器，用于自动化创建定制化标题卡片（剧集预览图片），适用于Plex、Emby、Jellyfin等个人媒体服务。它能够自动拉取数据并生成图片，无需人工干预，所有配置通过YAML文件完成，图片创建基于开源库ImageMagick。

核心功能与特性

• 多源数据拉取：可从Sonarr、Plex读取剧集信息，从Sonarr、Plex或电影数据库(TMDB)获取剧集数据，从TMDB或Plex获取图片
• 自动化处理：全程无需人工干预，支持批量处理所有系列
• 无剧透功能：利用Plex中的剧集观看状态，自动生成"无剧透"版本标题卡片，观看后自动解锁清晰版本
• 定制化配置：通过YAML文件进行全流程配置，支持多种卡片样式
• 开源图片处理：使用免费开源的ImageMagick库进行图片生成

使用场景与适用范围

适用于个人媒体库管理员，尤其是使用Plex、Emby或Jellyfin构建媒体服务器的用户，需要为剧集创建统一、美观、定制化预览图片的场景。无论是小型个人库还是大型媒体集合，均可通过自动化配置实现高效管理。

使用方法与配置说明

安装方式

Docker安装

参考Docker安装指南获取详细步骤。

Unraid用户

在Unraid社区应用商店搜索titlecardmaker，使用现成模板快速安装。

传统安装

查看Wiki上的入门指南。

运行方法

假设使用默认配置文件名，运行命令如下：

console
pipenv run python main.py --run

配置详情

所有配置和自动化设置通过YAML文件完成，具体配置方法请参考运行指南。

示例

内置卡片类型

以下是TitleCardMaker可自动生成的部分卡片样式示例：

依次为：Anime、Cutout、Divider、Fade、Frame、Landscape、Logo等标题卡片类型。

用户创建卡片类型

TitleCardMaker还支持用户创建和维护的卡片类型，托管在 companion GitHub 仓库，示例如下：

依次为：Yozora/BarebonesTitleCard、Beedman/GradientLogoTitleCard、Yozora/RetroTitleCard等用户自定义类型。

问题排查

如遇到使用问题，请参考运行指南或在GitHub上创建issue。

贡献

欢迎通过GitHub提交功能建议、bug修复或其他贡献，或加入***社区进行交流。技术相关问题建议在GitHub上管理。

支持

如果觉得该项目有用，可通过BuyMeACoffee或GitHub赞助支持开发者。