PosterPilot

PosterPilot 是一个自托管的 Web 应用，可浏览媒体库 （Plex、Jellyfin 或 Emby——一次激活一个），跨多个提供方查找封面海报， 并将选定的封面应用到你的媒体服务器——可直接通过其 API 应用，和/或通过导出 Kometa/PMM 兼容的 YAML 应用。它在 Mac 或 Unraid 服务器上作为单个 Docker 容器运行。

引导式的首次安装向导会带你从选择语言开始，逐步连接你的 服务器、TMDB 密钥和提供方，选择媒体库，并完成首次同步—— 对于 Plex，它还包含 PIN 登录和连接发现，这样你就永远不必 费力去查找 token 或 URL。

它能做什么

同步你的媒体库

同步你的电影和剧集媒体库，并将每个标题解析为 TMDB id，以便准确地查询封面提供方。

查找封面

跨所有启用的提供方——MediUX、Fanart.tv、TMDB 和 ThePosterDB——发散查找，并按提供方和套图分组比较海报 和背景候选项。可以使用整个套图、跨提供方混搭各个部分，或从粘贴的 URL 或上传的文件组装自定义套图。

应用封面

通过媒体服务器 API 应用选定的封面（即时上传并锁定该字段），和/或 通过 Kometa YAML 导出应用，由你的 Kometa 实例在下次运行时使用。

保持本地化

界面提供英语、西班牙语、简体中文、日语和巴西葡萄牙语版本，并带有 按键的英语回退——通过 Weblate 管理。

库范围的工作作为后台任务运行，并通过 Server-Sent Events 提供实时进度，直接显示在仪表板上。细粒度的 活动 日志（设置 → 活动）和一个滚动的文件日志会记录每一个操作事件， 而带有”What’s New”弹窗的更新检查器会提示新发布的版本。

接下来去哪里

安装 使用官方 GHCR 镜像，在 Mac 或 Unraid 上通过 Docker Compose 运行 PosterPilot。

配置 连接媒体服务器、设置你的 TMDB 密钥、启用封面提供方，并了解完整的环境变量参考。

使用 同步媒体库、查找封面、应用封面、构建自定义套图，并筛选库墙。

贡献 在本地搭建项目，并在提交更改前运行质量检查。

技术栈

• SvelteKit（TypeScript）运行于 Bun 之上，使用 adapter-node 构建
• SQLite + Drizzle ORM（libsql），用于库缓存、候选项、历史记录、 任务和设置
• Tailwind CSS v4，深色、以图像为主的界面
• 进程内任务队列，配合 Server-Sent Events 提供实时进度

PosterPilot 以 MIT License 发布。