Radarr 电影海报墙:从空白墙到私人画廊的完整指南
2026/9/12 17:04:10 网站建设 项目流程

Radarr 电影海报墙:从空白墙到私人画廊的完整指南

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

硬盘里躺着几百部片子,文件命名倒是规范,可打开文件夹还是一排灰扑扑的方格,毫无观感可言。想给家人或朋友展示收藏时,翻相册、找截图的狼狈场面谁都经历过。

如果你在用 Radarr 管理 Usenet 和 BitTorrent 的电影收藏,海报这活儿其实可以完全交给它:每部电影的海报、横幅、背景图会被自动抓取、压缩成多档尺寸,存在本地,再通过 Web 界面拼成一面随时可看的电影海报墙,还能直接喂给 Kodi、Plex 这类媒体中心。

海报墙能力全景:Radarr 替你干了什么

  • 自动抓取与本地化:添加电影并刷新元数据时,Radarr 就从 TMDb 等元数据源拉取高清海报,落地到本地磁盘,不再依赖外部热链。
  • 多尺寸自动生成:每张海报同时生成大、小两档尺寸,Web 页浏览用大图,网格缩略用小图,不用现场缩放。
  • 内置 Web 海报服务:海报通过本机接口直接分发,加载快,断外网也不影响内网浏览。
  • 收藏联动:电影删除时对应海报目录一并清理,墙不会越用越脏。
  • 媒体中心友好:生成的海报文件正是 Kodi、Plex 期望的结构,通知开启后自动更新它们的媒体库。

核心逻辑在 MediaCoverService,对外分发入口在 MediaCover 控制器。

配置实操:从最小可用到个性化

存储路径:零配置起步

海报默认存到应用数据目录下的MediaCover/{电影ID}/里,poster.jpg是原图,poster-500.jpgposter-250.jpg是两档缩略尺寸。想换位置,只需在 Settings → Media Management 里改 Application Data 文件夹,迁移完重启一次即可。

配置完成后你会看到:每部新电影入库,对应 ID 文件夹里自动多出一组海报文件,不用手动搬。

尺寸与缓存:基本不用操心

海报高度按类型自动分档:

Poster / Headshot → 500px, 250px Banner → 70px, 35px Fanart / Screenshot→ 360px, 180px

Web 界面引用本地海报 URL 时会带一段哈希参数,TMDb 换了新海报、本地刷新之后,浏览器缓存会自动失效,看到的永远是最新版。

配置完成后你会看到:海报墙刷新后立即可见新图,不用手动清浏览器缓存。

手动替换:一张图定终身

对自动匹配的海报不满意时,直接把同尺寸的图片按命名规范(如poster-500.jpg)放进对应电影的目录覆盖原文件,再到电影页面刷新元数据。

配置完成后你会看到:海报墙立刻展示你挑的这版图。

进阶玩法

批量刷新海报的 API 调用

大批量导入电影后想整墙重刷,用命令接口比在界面上点几十次省事:

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

命令 API 的完整参数说明,可在 openapi 定义 里查到。

给 Kodi / Plex 供海报

在 通知设置 里添加对应媒体中心的通知,勾选库更新事件即可。文件结构对齐后,海报墙从"给你自己看"变成全家都能看,几乎零额外成本。

避坑与速查

症状原因最短解法
海报显示空白占位图下载时网络或磁盘出错,文件未落地(日志有 "Couldn't download media cover")对该电影执行一次手动刷新
刷新后仍是旧海报浏览器缓存了旧图强制刷新页面,正常场景哈希参数会自动破缓存
树莓派上刷海报卡顿图片缩放按 CPU 核数的一半限制并发,ARM 上 ImageSharp 偏慢属预期行为,夜间低峰期批量刷即可

Radarr 把海报从"手动维护的负担"变成了"入库即生成的副产品",墙的效果上限取决于你的收藏规模,而不是你花的工时。往后若想让墙更个性,可以留意 Kodi 端的主题定制方向。

💡 提醒:MediaCover目录跟着应用数据目录走,做定期备份(System → Backups)时一并覆盖,重装后海报墙不用从零攒起。

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询