电影入库后别手贴海报了：Radarr 海报墙自动化攻略

电影入库后别手贴海报了：Radarr 海报墙自动化攻略

【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr

一部片子下完、改名、入库，海报却还是个灰色占位图——手动去网站找图、存图、改尺寸，一部要折腾十几分钟。Radarr 是面向 Usenet 和 BitTorrent 用户的电影收藏管理器，添加新电影时会自动拉取海报并按尺寸缩放存到本地，你的收藏很快就能拥有一面可展示的海报墙。

海报墙能力速览

• 自动获取海报：新电影入库即从 TMDb 等元数据源下载海报，落在本地 MediaCoverService.cs
• 多尺寸自动缩放：每种图按高度自动生成两档，海报 500/250、横幅 70/35、背景图 360/180
• 媒体中心同步：内置 Kodi、Plex 通知模块，影片下载完成或质量升级后自动触发媒体中心刷新

先把海报存储路径理清

目录长什么样：海报统一放在应用数据目录下的MediaCover文件夹，路径由 PathExtensions.cs 的GetMediaCoverPath拼出。每个电影 ID 一个子目录，文件名后缀的数字就是像素高度：

MediaCover/ ├── 1/ │ ├── poster.jpg │ ├── poster-500.jpg │ ├── poster-250.jpg │ ├── fanart.jpg │ └── fanart-360.jpg └── 2/ └── ...

Web 页面和媒体中心引用的其实是本地路径（URL 里带一段哈希后缀用来防缓存），不依赖在线图源。完成标志：打开数据目录，能看到按电影 ID 命名的子目录和对应 jpg 文件。

让海报自动下下来并刷新生效

触发时机：电影新增或更新会发出MovieUpdatedEvent，MediaCoverService收到后先检查文件是否已存在，不存在才下载，然后按类型缩放。缩放档位在这段 switch 里写死：

case MediaCoverTypes.Poster: case MediaCoverTypes.Headshot: heights = new[] { 500, 250 }; break; case MediaCoverTypes.Banner: heights = new[] { 70, 35 }; break;

手动刷新元数据：不满意自动抓的海报时，把同名图片按上面规范放好，再用RefreshMovie命令让 Radarr 重新走一遍流程（命令定义见 RefreshMovieCommand.cs）：

curl -X POST http://127.0.0.1:7878/api/v3/command \ -H "X-Api-Key: your-api-key" \ -d '{"name": "RefreshMovie", "movieIds": [1, 2]}'

API Key 在 Radarr 设置 → 常规 → 安全里获取。完成标志：命令跑完后，电影详情里的新图生效，电影目录下出现新的缩放假文件。

把墙挂到电视上

在设置 → 通知里添加 Kodi 或 Plex，填上媒体中心的地址（Kodi 需要 IP 和端口，Plex 需要 Server 地址），勾选"更新库"类事件。之后每次下载完成、改名或质量升级，Radarr 都会主动通知媒体中心刷新，电视上的海报墙和你的库保持同步。

海报下载失败与缓存的坑

• 海报一直是占位图：多半是元数据源缺图或网络不通。日志里搜Couldn't download media cover能看到具体是哪张图、什么原因；手动把图放到对应路径再跑一次RefreshMovie。
• 换了海报文件，页面还是旧图（配置看似正常但没生效）：你替换的只是原图，poster-500.jpg这类缩放假文件不会自动生成——缩放只发生在下载阶段。手动补跑RefreshMovie命令，让 Radarr 重新生成缩放假，页面才更新。
• 树莓 Pi 上缩放很慢：ImageSharp 在 ARM 上没有硬件加速，Radarr 把并发压到核心数的一半，一次刷很多部会排队。属正常现象，分批刷新即可。

海报墙跑起来之后

海报已经本地化、尺寸齐全，媒体中心那边开箱就能展示。接下来可以：

• 在媒体管理里调整海报命名与布局，和整套命名规则对齐
• 把RefreshMovie写进定时任务，定期全量刷新元数据
• 用通知模块接入更多媒体中心，覆盖多台设备

提示：MediaCover目录在应用数据目录下，备份配置时把它一起带上。重装系统后还原数据目录，海报墙就能原样恢复，不用重新下载。

【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr