collinheist/titlecardmaker

TitleCardMaker

概述

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

核心功能与特性

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

使用场景与适用范围

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

使用方法与配置说明

安装方式

Docker安装

参考https://github.com/CollinHeist/TitleCardMaker/wiki/Docker-Tutorial%E8%8E%B7%E5%8F%96%E8%AF%A6%E7%BB%86%E6%AD%A5%E9%AA%A4%E3%80%82

Unraid用户

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

传统安装

查看Wiki上的https://github.com/CollinHeist/TitleCardMaker/wiki%E3%80%82

运行方法

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

console
pipenv run python main.py --run

配置详情

所有配置和自动化设置通过YAML文件完成，具体配置方法请参考https://github.com/CollinHeist/TitleCardMaker/wiki/Running-the-TitleCardMaker%E3%80%82

示例

内置卡片类型

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

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

用户创建卡片类型

TitleCardMaker还支持用户创建和维护的卡片类型，托管在https://github.com/CollinHeist/TitleCardMaker-CardTypes%EF%BC%8C%E7%A4%BA%E4%BE%8B%E5%A6%82%E4%B8%8B%EF%BC%9A

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

问题排查

如遇到使用问题，请参考https://github.com/CollinHeist/TitleCardMaker/wiki/Running-the-TitleCardMaker%E6%88%96%E5%9C%A8GitHub%E4%B8%8Ahttps://github.com/CollinHeist/TitleCardMaker/issues/new%E3%80%82

贡献

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

支持

如果觉得该项目有用，可通过BuyMeACoffee或https://github.com/***/CollinHeist%E6%94%AF%E6%8C%81%E5%BC%80%E5%8F%91%E8%80%85%E3%80%82