Media Preview Generator：为 Plex、Emby 与 Jellyfin 提前生成预览

项目用途

Media Preview Generator 面向运行 Plex、Emby 或 Jellyfin 的家庭媒体服务器。它以 Docker 容器运行，在 Sonarr 或 Radarr 导入文件后触发任务，为视频生成时间轴预览缩略图，并尝试提供 Skip Intro 与 Skip Credits 标记。多个服务器保存同一文件时，项目宣传的工作流是先解码一次，再分别写入各服务器需要的格式。

它适合希望新媒体尽快拥有可拖动预览、同时维护多个媒体服务器，或不想等待服务器自身后台任务的自托管用户。对只使用单一服务器、且内置生成任务已经跟得上的人，README 明确表示没有必要额外部署。

已知功能

项目支持 Sonarr、Radarr、Sportarr、Tdarr、FileFlows，以及 Plex、Emby、Jellyfin 的 webhook；也支持 Recently Added 轮询、cron、interval 和手动按标题或媒体目录生成。任务可在服务器索引新文件期间重试，并跳过已有最新预览的文件。

GPU 是主要路径，但不是硬性要求。README 列出 Linux 上的 NVIDIA、Intel 和 AMD GPU，以及通过 WSL2 使用 NVIDIA 的 Windows 场景；无法由 GPU 解码的文件会回退到 CPU。项目还提供关键帧跳转，并声称可处理 HDR10、HLG、HDR10+，以及 Dolby Vision 7、8 的 HDR10 层；Dolby Vision Profile 5 需要具备硬件 Vulkan 驱动的 GPU。

预览输出会按服务器采用不同格式：Plex 使用其数据目录中的 BIF，Emby 使用视频旁的 BIF，Jellyfin 使用 trickplay tiles。Skip Intro 与 Skip Credits 可从章节、在线数据库、季主题曲或片尾识别；项目在不确定时不直接提交猜测，而是等待人工复核。该功能还需要按服务器启用，并受 Plex、Emby 或 Jellyfin 的额外条件影响。

部署前限制与考虑

基础条件包括 Docker、容器能够访问媒体服务器，以及对预览写入位置拥有权限。Plex 的预览写入其数据目录；Emby 和 Jellyfin 的默认布局通常要求媒体挂载可写。GPU 并非必需，但使用 GPU 时仍需主机驱动；README 还特别提到 Linux NVIDIA 需要 NVIDIA Container Toolkit。

集成条件不能忽略：Plex 的相关标记功能需要 Plex Pass，并涉及服务器及观看者权限；Jellyfin 需要 Media Preview Bridge 插件，README 对 Jellyfin 版本和文档描述存在“10.11 或 12.0”以及快速开始“10.10 或更新”的不同表述，采用前应以项目当前文档和自身环境核对。Emby 需要对应插件，Skip Intro 还需要 Emby Premiere。具体兼容性、资源需求和实际处理速度，来源未给出统一保证，不能据此推断性能。

还要避免重复工作。启用本项目后，应检查各媒体服务器自己的预览生成设置；README 警告关闭 Jellyfin trickplay 可能删除本项目写入的图块。官方 4.4.2 修正了缩略图质量提示的方向错误：该设置数值越低通常代表更清晰，默认值保持为 4。项目采用 MIT License，但这不等于为媒体文件、服务器凭据或网络暴露提供安全保证；部署时仍应自行限制访问范围、妥善保管认证配置，并先在小规模库中验证写入路径与插件行为。

资料来源

• GitHub repository metadata
• Project README
• Official release
• Official project page

资料核对日期：2026-09-28