ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Radarr 海报墙实战路径:从灰底占位图到满墙海报

Radarr 海报墙实战路径:从灰底占位图到满墙海报 Radarr 海报墙实战路径从灰底占位图到满墙海报【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr凌晨三点整理完一批新片打开媒体库发现海报全是灰底占位图——这种时刻最考验收藏者的耐心。Radarr 海报墙要解决的就是这件事把电影海报自动拉下来、缩放好、按片归档让收藏一眼可见。本文沿着 MediaCover 模块海报服务的源码所在走一遍怎么让海报自动归位、怎么批量刷新、怎么接到媒体中心顺带讲清楚它为什么这么设计。项目能力速览Radarr 是面向 Usenet 和 BitTorrent 用户的电影整理/管理工具下载、元数据、海报一条龙。自动海报下载— 电影添加或更新即触发下载无需手动扒图多尺寸缩略图— 原图之外自动生成 500px/250px 等多档前端按需加载按片归档— 每部电影一个以 ID 命名的目录结构固定、可整体备份事件驱动— 靠内部事件总线联动没有常驻脚本要维护和纯手工管海报比手动整理Radarr新片海报自己下载命名添加影片自动到位缩略图自己裁剪自动生成多档环境准备与首次运行前置条件一句话.NET 8 运行时项目目标框架见 Radarr.csproj或直接使用官方发布的预编译包服务默认监听 7878 端口Bootstrap.csL149。git clone https://gitcode.com/GitHub_Trending/ra/Radarr # 拿到完整源码 cd Radarr # 进入项目目录 dotnet publish src/NzbDrone.Host -c Release # 编译出可执行程序 dotnet run --project src/NzbDrone.Host # 启动服务浏览器打开http://localhost:7878按首次引导配好媒体库路径即可。 核心功能实操让 Radarr 海报墙亮起来海报自动归位添加电影的那一秒海报就已经在落盘了全程零操作。触发链路是电影保存后发出更新事件MediaCoverService作为事件订阅者被唤醒逐张检查并下载。入口在 MediaCoverService.csL227-L232public void HandleAsync(MovieUpdatedEvent message) { var updated EnsureCovers(message.Movie); // ... }下载前会先查一次AlreadyExists同文件 L124已存在就跳过所以刷新命令不怕重复执行。一个细节电影尚未入库时图片 URL 会改走/MediaCover本地代理L73-L100绕开源站的防盗链。注意下载失败只记 Warn 日志L132-L143不会阻塞电影入库海报稍后补即可。一部电影三档尺寸同一张海报Radarr 会存原图加两张缩小版列表页、详情页各取所需加载飞快。文件名规则在GetCoverPath同文件 L66-L71封面类型名 高度后缀比如poster-500.jpg。各类型的缩放档位定义在EnsureResizedCoversL182-L194类型生成高度Poster / Headshot500、250Banner70、35Fanart / Screenshot360、180落盘后的目录长这样根目录即应用数据下的MediaCover见 PathExtensions.csL334-L337MediaCover/ ├── 128/ │ ├── poster.jpg # 原图 │ ├── poster-500.jpg # 中图 │ ├── poster-250.jpg # 缩略图 │ └── fanart-360.jpg └── 305/上面这只举牌怪就是 Radarr 前端 404 时的样子——海报缺位时你大概率会先见到它。另一个小提醒Clearlogo类型存.png其余默认.jpgL218-L225。批量刷新海报库换了图片源或者补库之后不用在界面上逐部点刷新一条 API 命令全库重扫。命令入口在 CommandController.csRefreshMovie命令类型定义见 TaskManager.csL89curl -X POST http://localhost:7878/api/v3/command \ -H X-Api-Key: 你的API密钥 \ -d {name: RefreshMovie}刷新会重新触发上面的下载与缩放流程已存在的文件自动跳过。API 密钥在 Settings → General 里拿忘了填或填错会直接 401。⚙️ 深度定制与生态集成对接媒体中心Kodi / Plex / Emby适用谁想让客厅大屏同步看到海报墙的人怎么做Settings → Notifications → 添加对应媒体服务器通知填地址和端口启用更新通知开关注意Radarr 只负责喊一嗓子发通知事件扫描入库动作仍在媒体服务器侧完成把 MediaCover 目录整体搬到 NAS适用谁本地盘小、海报想跟影片放一起的人怎么做停服 → 修改配置中应用数据路径 → 把MediaCover目录整体移动过去注意电影 ID 命名的子目录名千万不要改改一个丢一片前端样式微调适用谁受够了默认间距和悬停效果的人怎么做前端源码在 frontend/src/海报网格样式可参考修改.poster-cell { margin: 10px; transition: transform .3s; } .poster-cell:hover { transform: scale(1.05); }注意官方没有预留用户级样式注入点这类改动需自行维护构建产物升级前先记录 diff⚠️ 踩坑速查现象大概率原因解法一句话海报是灰底/404 占位源图地址失效或网络不稳看日志中 Couldnt download 记录只有原图没有小图缩放失败回退用了原图查 L206-L213 回退逻辑与磁盘空间API 刷新返回 401X-Api-Key 缺失或写错去 Settings → General 重新拷贝页面打不开7878 端口被占改配置文件中的服务端口需要更细的线索直接翻 MediaCoverService.csL107-L163的异常分支注释写得比多数文档都诚实。你现在已经能让海报随电影自动落盘、看懂多档缩略图的命名与目录结构、用一条命令刷新全库、并把海报墙接到媒体中心。进阶方向可以看看自定义封面代理、海报自动备份、前端主题改造。提示MediaCover目录独立于影片库重装前花两分钟打包备份ID 目录名原样保留即可无缝恢复。打开设置页把媒体库指到你的 NAS5 分钟后第一面海报墙就会亮起来。【免费下载链接】RadarrMovie organizer/manager for usenet and torrent users.项目地址: https://gitcode.com/GitHub_Trending/ra/Radarr创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表