TitleCardMaker YAML配置深度指南：打造个性化媒体服务器界面

TitleCardMaker YAML配置深度指南：打造个性化媒体服务器界面

【免费下载链接】TitleCardMakerAutomated title card maker for Plex, Jellyfin, and Emby项目地址: https://gitcode.com/gh_mirrors/ti/TitleCardMaker

TitleCardMaker是一款强大的自动化标题卡片生成工具，专为Plex、Jellyfin和Emby媒体服务器设计。通过灵活的YAML配置，用户可以轻松自定义标题卡片的外观和行为，打造独特的媒体库界面。本文将深入探讨YAML配置的各个方面，帮助新手用户快速掌握个性化配置技巧。

YAML配置基础：轻松入门

YAML是一种简洁易读的数据序列化格式，非常适合用于配置文件。在TitleCardMaker中，YAML文件用于定义媒体库、系列和卡片的各种属性。通过修改这些配置，您可以完全控制标题卡片的生成方式。

核心配置文件

TitleCardMaker的主要配置来自以下几个关键文件：

• 偏好设置文件：全局配置，如媒体服务器连接、默认卡片类型等
• 系列YAML文件：定义特定系列的卡片样式和行为
• 模板文件：可重用的配置模板，简化多个系列的设置

基本结构示例

一个典型的系列YAML配置可能如下所示：

libraries: TV Shows: path: /media/tv media_server: plex series: "Breaking Bad": card_type: StandardTitleCard season_folder_format: "Season {season:02d}" font: color: "#FFFFFF" size: 120

关键配置选项解析

媒体库配置

媒体库配置告诉TitleCardMaker您的媒体文件存储位置以及对应的媒体服务器。这是生成标题卡片的基础。

libraries: "Anime Collection": path: /media/anime media_server: emby card_directory: /media/anime/posters

• path: 媒体文件所在的目录
• media_server: 关联的媒体服务器（plex、emby或jellyfin）
• card_directory: 生成的标题卡片存放位置（可选）

图：TitleCardMaker使用渐变背景创建视觉吸引力的标题卡片

系列特定配置

对于每个系列，您可以定义独特的卡片样式和行为：

series: "Stranger Things": card_type: FrameTitleCard template: netflix_style season: 1: font: file: modules/ref/frame/guess-sans-medium.otf color: "#E50914" 2: background: color: "#000000"

• card_type: 指定卡片类型（如FrameTitleCard、BannerTitleCard等）
• template: 应用预定义模板
• season: 为特定季节设置独特样式

卡片类型与视觉效果

TitleCardMaker提供多种预设卡片类型，每种都有独特的视觉风格：

• StandardTitleCard: 简洁的标准样式
• FrameTitleCard: 带边框的卡片
• BannerTitleCard: 横幅式标题
• AnimeTitleCard: 专为动漫设计的样式

图：FrameTitleCard类型使用自定义边框增强视觉效果

高级配置技巧

使用模板提高效率

模板允许您创建可重用的配置集，大幅减少重复工作：

templates: netflix_style: card_type: StandardTitleCard font: file: modules/ref/banner/Gill Sans Nova ExtraBold.ttf color: "#E50914" background: opacity: 0.7

然后在系列配置中引用模板：

series: "The Witcher": template: netflix_style season: 1: background: image: custom_background.jpg

字体与颜色定制

TitleCardMaker支持丰富的字体和颜色定制选项：

font: file: modules/ref/marvel/Qualion ExtraBold.ttf color: "#FF0000" size: 140 stroke_color: "#000000" stroke_width: 2 shadow: true shadow_color: "#00000080" shadow_offset: [2, 2]

图：使用自定义字体和渐变背景创建的星球大战风格标题卡片

图片源与背景设置

您可以配置图片来源优先级和背景效果：

image_source_priority: - tmdb - plex - emby background: type: gradient gradient: start_color: "#1A1A1A" end_color: "#333333" direction: vertical blur: 5

常见问题与解决方案

配置验证错误

如果您的YAML配置有误，TitleCardMaker会在启动时提供详细错误信息。常见问题包括：

• 缩进不正确（YAML对缩进非常敏感）
• 键名拼写错误
• 数据类型不匹配（如将字符串用于需要数字的地方）

解决方法：使用YAML验证工具检查您的配置文件。

卡片不生成或生成错误

如果标题卡片没有按预期生成，请检查：

1. 媒体服务器连接是否正常
2. 媒体文件路径是否正确
3. 权限设置是否允许TitleCardMaker读写文件
4. 日志文件（通常在logs/目录下）获取详细错误信息

性能优化

对于大型媒体库，您可以通过以下配置提高性能：

options: execution_mode: parallel validate_fonts: false image_source_priority: - plex - local

总结：释放媒体服务器的视觉潜力

通过本文介绍的YAML配置技巧，您可以完全自定义TitleCardMaker的行为，为您的媒体服务器创建独特而专业的标题卡片。从简单的字体颜色调整到复杂的模板创建，YAML配置为您提供了无限可能。

无论您是Plex、Jellyfin还是Emby用户，TitleCardMaker都能帮助您将媒体库提升到新的视觉水平。开始探索YAML配置的强大功能，打造专属于您的个性化媒体中心吧！

图：使用TitleCardMaker创建的电影海报风格标题卡片，带有星星覆盖效果

【免费下载链接】TitleCardMakerAutomated title card maker for Plex, Jellyfin, and Emby项目地址: https://gitcode.com/gh_mirrors/ti/TitleCardMaker