Jellyfin/Emby用户必看：Posterizarr插件安装与媒体资产同步完整指南

【免费下载链接】Posterizarr🖼️ Automated poster maker for Plex/Jellyfin/Emby.项目地址: https://gitcode.com/gh_mirrors/po/Posterizarr

Posterizarr是一款强大的自动化海报制作工具，专为Plex、Jellyfin和Emby媒体服务器设计。这个终极工具能够自动从TMDB、Fanart.tv、TVDB等平台获取高质量的无文字海报，为您的媒体库创建美观统一的视觉体验。对于Jellyfin和Emby用户来说，Posterizarr插件提供了无缝的本地资产同步功能，让您的媒体库焕然一新。

为什么选择Posterizarr？ 🤔

Posterizarr不仅是一个简单的海报生成工具，它是一个完整的自动化解决方案。通过智能的图像获取和本地资产管理，它能够：

• 自动获取高质量海报：从多个数据源获取4K分辨率的海报
• 支持无文字版本：专注于获取无文字海报，保持界面整洁
• 多服务器支持：同时兼容Plex、Jellyfin和Emby
• Web UI管理：通过直观的Web界面管理所有设置
• 智能同步：自动同步本地资产到媒体服务器

准备工作与基础安装 🚀

获取必要的API密钥

在开始之前，您需要准备以下API密钥（全部免费）：

1. TMDB API Token：从TMDB网站获取
2. Fanart API Key：从Fanart.tv获取
3. TVDB Project API Key：从TVDB获取

Docker快速安装（推荐）

最简单的安装方式是通过Docker容器：

# 克隆仓库 git clone https://gitcode.com/gh_mirrors/po/Posterizarr cd Posterizarr # 启动Docker容器 docker-compose up -d

安装完成后，访问http://localhost:8000即可进入Posterizarr的Web管理界面。

基础配置步骤

1. 复制配置文件模板：

   cp config.example.json config.json

2. 编辑config.json文件，添加您的API密钥和服务器信息

3. 首次运行测试：

   # Docker环境 docker exec -it posterizarr pwsh /app/Posterizarr.ps1 -Testing # Windows/Linux环境 ./Posterizarr.ps1 -Testing

Jellyfin插件安装教程 🎯

通过仓库安装（推荐方法）

1. 打开Jellyfin控制面板

2. 导航至插件→仓库

3. 点击添加并输入：

   • 仓库名称：Posterizarr
   • 仓库URL：https://raw.githubusercontent.com/fscorrupt/posterizarr/main/manifest.json

4. 切换到目录标签页

5. 在元数据类别下找到Posterizarr

6. 点击安装并选择最新版本

7. 重启您的Jellyfin服务器

插件配置与使用

1. 重启后，进入插件→已安装插件，点击Posterizarr
2. 点击设置按钮
3. 配置资产根路径（存放您整理好的图片的目录）
4. 保存设置
5. 进入控制面板→媒体库
6. 管理一个媒体库（例如：电影库）
7. 在图像获取器设置中启用Posterizarr
8. 根据您的偏好调整优先级顺序
9. 刷新元数据（搜索缺失的元数据 →替换现有图像）以获取本地资产

Emby插件安装指南 📦

手动安装步骤

1. 从GitHub发布页面下载最新版本的Posterizarr.Plugin.Emby.dll

2. 将文件复制到Emby服务器的插件目录：

   • Docker环境：/config/plugins/
   • Windows环境：%appdata%\Emby-Server\programdata\plugins

3. 重启您的Emby服务器

插件配置详解

1. 重启后，进入控制面板→插件→已安装插件，点击Posterizarr Emby
2. 点击设置
3. 配置根资产文件夹路径（例如：/assets）
4. 点击保存
5. 进入控制面板→媒体库
6. 管理一个媒体库（例如：电影库）
7. 在图像获取器设置中启用Posterizarr
8. 根据您的偏好调整优先级顺序
9. 刷新元数据（搜索缺失的元数据→替换现有图像）以获取本地资产

自动化同步任务设置 ⏰

Posterizarr Emby插件提供了强大的计划任务功能，让资产同步完全自动化：

配置同步计划

1. 打开Emby控制面板

2. 在左侧边栏的服务器部分，导航至计划任务

3. 在列表中找到Posterizarr同步任务

4. 点击任务以自定义触发器：

   • 可以配置任务按间隔运行
   • 在特定时间运行（例如：每天凌晨3:00）
   • 系统启动时运行
   • 按周计划运行

5. 您也可以随时通过点击任务旁边的**播放（运行）**按钮手动触发任务

高级配置技巧 🛠️

语言偏好设置

在config.json中，您可以精细控制语言偏好：

"PreferredLanguageOrder": ["xx", "en", "de"], "PreferredSeasonLanguageOrder": ["xx", "en", "de"], "PreferredBackgroundLanguageOrder": ["PleaseFillMe"], "PreferredTCLanguageOrder": ["PleaseFillMe"], "LogoLanguageOrder": ["en", "de"]

• xx表示无文字版本（优先获取无文字海报）
• 语言代码使用ISO 3166-1标准

媒体库特定语言覆盖

对于多语言媒体库，可以单独设置：

"LibraryLanguageOverrides": { "德语电影": { "PreferredLanguageOrder": ["de", "en"] }, "法语电影": { "PreferredLanguageOrder": ["fr", "en"] } }

图像质量过滤

确保只获取高质量图像：

"WidthHeightFilter": true, "PosterMinWidth": 2000, "PosterMinHeight": 3000, "BgTcMinWidth": 3840, "BgTcMinHeight": 2160

常见问题解决 🔧

无法访问Web UI？

如果无法从其他设备访问Web UI，请检查网络配置。确保防火墙允许端口8000的访问，或者在Docker配置中正确映射端口。

插件不显示图像？

1. 确认资产路径配置正确
2. 检查文件权限
3. 确保已刷新媒体库元数据
4. 验证API密钥是否正确配置

同步速度慢？

• 检查网络连接
• 调整API请求频率
• 考虑使用本地缓存

最佳实践建议 💡

1. 定期备份配置

定期备份您的config.json文件，特别是当您进行了大量自定义设置后。

2. 分阶段实施

建议先在一个小型测试媒体库中试用Posterizarr，确认一切正常后再应用到整个媒体库。

3. 监控资源使用

Posterizarr在处理大型媒体库时可能会占用较多资源，建议在系统空闲时段运行。

4. 利用计划任务

充分利用Emby插件的计划任务功能，设置夜间自动同步，确保媒体库始终保持最新状态。

性能优化技巧 ⚡

缓存策略优化

通过合理配置缓存设置，可以显著提升Posterizarr的性能：

1. 启用本地缓存：减少重复的API请求
2. 设置合理的缓存过期时间：平衡新鲜度与性能
3. 使用CDN加速：对于大型部署考虑使用CDN

批量处理优化

对于大型媒体库，建议：

1. 分批处理：不要一次性处理所有媒体
2. 优先级设置：先处理热门或新添加的内容
3. 错误重试机制：配置适当的重试策略

安全注意事项 🔒

1. API密钥保护

• 不要将API密钥提交到公开仓库
• 定期轮换API密钥
• 使用环境变量存储敏感信息

2. 访问控制

• 为Web UI启用基本身份验证
• 限制网络访问范围
• 定期更新密码

3. 数据备份

• 定期备份生成的资产文件
• 备份配置文件
• 考虑使用版本控制系统管理配置变更

结语 🎉

Posterizarr为Jellyfin和Emby用户提供了一个强大的自动化海报管理解决方案。通过本文的完整指南，您应该能够顺利安装配置Posterizarr插件，并实现媒体资产的自动化同步。

记住，良好的配置是成功的一半。花时间仔细配置您的偏好设置，特别是语言偏好和图像质量过滤，这将显著提升最终效果。

开始使用Posterizarr，让您的媒体库焕然一新！如果您遇到任何问题，可以参考项目文档或社区支持资源。祝您使用愉快！ 🚀

提示：定期检查更新，Posterizarr团队会不断改进功能和修复问题，保持软件最新可以获得最佳体验。

【免费下载链接】Posterizarr🖼️ Automated poster maker for Plex/Jellyfin/Emby.项目地址: https://gitcode.com/gh_mirrors/po/Posterizarr