深色模式
Emby 封面生成
Emby 封面生成用于给 Emby 媒体库生成静态或动态封面。它支持手动制作、自动化定时生成、入库监控触发、字体和颜色配置、名称映射以及任务日志。
页面标签
| 标签 | 作用 |
|---|---|
| 静态封面 | 生成图片封面 |
| 动态封面 | 生成 GIF / APNG 等动态封面 |
| 日志 | 查看生成记录和错误 |
配置区域
| 区域 | 说明 |
|---|---|
| 封面制作 | 选择 Emby 服务器、媒体库、图片来源和风格 |
| 颜色设置 | 配置背景色、字体色等视觉参数 |
| 自动化 | 定时生成、入库监控、延迟触发 |
| 名称映射 | 按媒体库名称定制标题、颜色、风格 |
手动制作
手动制作适合先试效果，或只给某个媒体库单独生成一次。
| 字段 | 说明 |
|---|---|
| 封面风格 | 静态风格或动态风格 |
| Emby 服务器 | 选择要读取媒体库的 Emby 配置 |
| 媒体库 | 选择目标媒体库 |
| 图片来源 | 随机图片、最新图片或本地上传 |
| 优先使用主图 | 优先使用 Emby 主图 |
| 临时中文标题 | 本次生成覆盖中文标题 |
| 临时英文标题 | 本次生成覆盖英文标题 |
| 字体与字号 | 中英文字体、大小、偏移、间距 |
图片来源
text
随机图片
最新图片
本地上传自动化通常使用 Emby 随机图或最新图；手动制作可以上传本地图片。
静态封面参数
| 参数 | 说明 |
|---|---|
| 静态分辨率 | 选择预设输出尺寸 |
| 自定义宽度 | 使用自定义分辨率时填写 |
| 自定义高度 | 使用自定义分辨率时填写 |
| 背景颜色模式 | 自动提取、名称映射配置、马卡龙、鲜明色、自定义 |
| 背景模糊 | 背景图模糊程度 |
| 混色比例 | 背景色与图片的混合比例 |
动态封面参数
| 参数 | 说明 |
|---|---|
| 动图格式 | APNG 或 GIF |
| 动图分辨率 | 例如 320x180 |
| 动画循环周期 | 单轮动画时长 |
| FPS | 动画帧率 |
| 滚动方向 | 交替、反向交替、向上、向下 |
| 动画图片数量 | 参与动图的图片数量 |
| 离场动画 | 飞出、淡出、交叉淡入淡出 |
| 色彩压缩 | 关闭、中等、强压缩 |
自动化
自动化支持定时生成和入库监控触发。
| 字段 | 说明 |
|---|---|
| 启用自动化总开关 | 自动化主开关 |
| 启用定时生成 | 按 Cron 定时生成 |
| 定时生成 Cron | 5 位 Cron 表达式 |
| 启用入库监控 | Emby 入库后触发封面生成 |
| 入库后延迟 | 入库后等待多少秒再生成 |
| 自动化媒体库 | 可多选媒体库 |
| 图片来源 | 随机图片或最新图片 |
| 封面风格 | 自动生成时使用的风格 |
名称映射示例
yaml
港台电影:
zh_title: 港台电影
en_title: HK-TW Movies
bg_color: "#C0392B"
image_source: emby_latest
style: animated_3
zh_font_color: "#FFFFFF"
欧美剧:
zh_title: 欧美剧
en_title: US-EU Series
style: static_2
color_ratio: 0.75名称映射只用于自动化。与全局配置冲突时，以映射里的媒体库配置为准。
常用字段：
| 字段 | 说明 |
|---|---|
zh_title | 中文标题 |
en_title | 英文标题 |
image_source | emby_random 或 emby_latest |
style | static_1 到 static_5，或 animated_1 到 animated_5 |
bg_color | 背景色 |
zh_font_color | 中文字体颜色 |
en_font_color | 英文字体颜色 |
blur_size | 背景模糊 |
color_ratio | 混色比例 |
use_primary | 是否优先使用主图 |
animation_resolution | 动态封面分辨率 |
animation_fps | 动态封面帧率 |
自动化流程
text
选择 Emby 服务器 -> 选择媒体库 -> 设置风格和图片来源 -> 开启定时或入库监控 -> 自动生成并上传封面常见问题
生成失败
检查 Emby 配置、媒体库权限、图片来源是否可获取、本地字体是否存在。
动态封面太大
降低分辨率、FPS、动画图片数量，或启用色彩压缩。
入库后没有自动刷新封面
检查自动化总开关、入库监控开关、媒体库匹配和延迟秒数。
字体怎么添加
把字体文件放到 NanShare 配置目录下的媒体封面字体目录，然后刷新页面重新选择字体。中文和英文字体分别在对应分类里选择。
名称映射不生效
检查媒体库名称是否和 Emby 返回名称完全一致，YAML 缩进是否正确，字段名是否写错。名称映射只影响自动化，不影响手动临时标题。