Ruddarr完全指南:开源免费的Radarr与Sonarr手机伴侣App,一个应用管理全部影视库
Ruddarr完全指南:开源免费的Radarr与Sonarr手机伴侣App,一个应用管理全部影视库
Ruddarr 是一款开源免费的 iOS 原生应用,作为 Radarr 与 Sonarr 实例的手机伴侣App,让一个应用就能管理你的全部影视库:浏览电影与剧集、查看日历预告、跟踪下载队列、接收推送通知,还支持多实例切换与 iCloud 跨设备同步。下面这份指南将带新手快速上手这款影视库管理工具。
为什么选择 Ruddarr:Radarr 与 Sonarr 手机管理的最优解
如果你自建有 Radarr(电影)和 Sonarr(剧集),日常最大的痛点往往是:服务器藏在 NAS 里,想确认"新片下完了没有"却要掏出电脑打开网页。Radarr / Sonarr 自带的 Web 界面并非为小屏设计,滑动、缩放、返回都很费劲。
Ruddarr 用 SwiftUI 从零打造了一套原生体验,把 Radarr 与 Sonarr 的核心能力完整搬到了 iPhone 和 iPad 上,同时也提供了 macOS 版本:
| 场景 | Radarr / Sonarr 网页版 | Ruddarr 手机App |
|---|---|---|
| 确认下载进度 | 打开浏览器缩放页面 | 活动页一屏看完队列 |
| 发现新片/新季 | 手动去 TMDB 翻找 | 日历页按日期浏览预告 |
| 添加媒体 | 小屏上操作繁琐 | 搜索 + 一键添加 |
| 外出时收到下载完成 | 没有通知,只能手动查 | 细粒度推送直达手机 |
| 管理多个实例 | 来回切换书签 | App 内一键切换 |
Ruddarr 核心功能一览:电影、剧集、日历与下载队列
Ruddarr 的主界面由几个核心标签页组成(见 Ruddarr/Views/ContentView.swift):
- 🎬 Movies(电影):海报/卡片双网格浏览电影库,支持搜索、排序、快速预览海报,长按可直接监控或删除影片
- 📺 Series(剧集):按季、按集浏览剧集文件,查看每集的下载与评分信息
- 📅 Calendar(日历):按日期浏览即将发布的电影和新集,追更一目了然
- ⚡ Activity(活动):实时查看下载队列任务、失败原因与历史事件(iPad 上另有独立 History 侧栏)
- ⚙️ Settings(设置):管理实例、主题、图标与诊断信息
此外还内置了几项"小而美"的能力:
- 🔔 细粒度推送通知(影片入库、下载失败、质量降级等)
- 🔄 多实例切换 + iCloud 同步设置
- 🔍 Spotlight 全局搜索,直接跳到指定影片
- 🌐 完整多语言本地化,支持社区翻译
快速上手:添加你的第一个 Radarr / Sonarr 实例
首次配置只需 3 步,整个过程不到 1 分钟:
- 打开 Ruddarr → 进入 Settings → Instances,点击新增实例
- 填写实例地址与 API Key:即你 Radarr / Sonarr 的访问地址(如
http://192.168.1.10:7878)和 API 密钥 - 保存,App 会自动连接并拉取媒体库
实例的完整数据结构定义在 Ruddarr/Models/Instances/Instance.swift,编辑界面见 Ruddarr/Views/Settings/InstanceEditView.swift,几个常用选项值得了解:
| 选项 | 说明 |
|---|---|
| URL | 实例主地址,支持 http/https |
| Alternate URL | 备用地址,App 会自动探测网络并择优连接,家里和外面无缝切换 |
| API Key | 在 Radarr/Sonarr 的 Settings → General 中获取 |
| Custom Headers | 自定义 HTTP 头,用于反向代理场景(含 Basic 认证助手) |
| Slow 模式 | 针对慢速实例自动放宽请求超时 |
⚠️ 小提示:2.0.0 版本起 Ruddarr 已移除对 Sonarr v3 的支持,请使用 Sonarr v4 及以上版本。版本演进可参考 CHANGELOG.md。
功能详解:日历预告、下载队列与推送通知
📅 日历页是 Ruddarr 最受欢迎的功能之一:它按日期聚合 Radarr 即将上映的电影和 Sonarr 即将更新的新集,点开即可查看详情、搜索发行资源。相比在网页里逐个查看,手机上"今天有什么新内容"一屏就能回答。
⚡ 活动页实时展示队列中的下载/导入任务:进度、剩余时间、出错原因尽收眼底;点击任务还能直接跳转到对应的电影或剧集详情。iPad 的侧栏中另有 History 标签,方便回溯历史事件。
🔔 推送通知让手机真正成为你的"远程控制台":影片入库、下载失败、质量变更等事件都会推送到设备。通知服务端同样采用开源方案,实现代码位于 Ruddarr/Services/Notifications.swift 与独立的 NotificationService/ 扩展中。
多实例切换与 iCloud 同步:跨设备管理全部影视库
自建党往往不止一个实例(本地一套、VPS 一套,电影剧集分开部署)。Ruddarr 原生支持:
- 在设置中分别添加多个 Radarr / Sonarr 实例,任意页面顶部即可切换
- 实例配置、主题偏好通过 iCloud 自动同步,iPhone 上改完,iPad 和 Mac 上立即生效
- 支持自定义 HTTP 请求头,配合 Nginx 等反向代理和认证网关使用
实例的存储与切换逻辑见 Ruddarr/Services/InstancesStore.swift 与 Ruddarr/Services/InstanceResolver.swift。
个性化定制:主题配色与 10 款应用图标
Ruddarr 在颜值上下了不小的功夫:
- 🎨 11 套主题配色:蓝、紫、绿、红、橙、黄、单色、棕色、Barbie、Plex 等,完整列表见 Ruddarr/Services/Theme.swift
- 🌓 外观模式:自动 / 浅色 / 深色
- 🖼️ 网格样式:Posters(海报墙)或 Cards(信息卡片)
- 🎭 10 款 App 图标:在设置中一键更换桌面图标,融入各种风格的图标主题
其中部分个性图标(如 Warp、ATP、Telegram 等)需要订阅 Ruddarr+ 解锁;不订阅也能免费使用全部核心功能,App 本体开源免费。
自动化玩法:Siri 快捷指令与 ruddarr:// 深度链接
喜欢自动化的玩家不会失望。Ruddarr 内置了 Siri 快捷指令(见 Ruddarr/Services/Shortcuts.swift):
- "Add Movie / 添加电影到 Ruddarr"
- "Add Series / 添加剧集到 Ruddarr"
- "Open Ruddarr / 打开 Ruddarr"
同时支持 ruddarr:// URL Scheme 深度链接,可以直接打开日历、活动页、电影/剧集搜索等页面,方便接入 Shortcuts 工作流。全部可用 Scheme 列在 Ruddarr/Dependencies/QuickActions.swift。
本地化、版本与源码构建
- 🌐 多语言:Ruddarr 已完整本地化,字符串目录维护在 Ruddarr/Localizable.xcstrings,欢迎参与翻译
- 📱 平台支持:iOS、iPadOS、macOS,并跟进最新系统特性(如 iPhone Duo 支持,见 CHANGELOG.md)
- 🔧 源码构建:使用 Xcode 打开项目即可构建。克隆仓库:
git clone https://gitcode.com/gh_mirrors/app154/app
预览用的示例数据(日历、队列、媒体库 JSON 等)位于 Ruddarr/Preview Content/,开发规范见 AGENTS.md。
总结
Ruddarr 证明了"伴侣App"可以做得多完整:从电影、剧集、日历到下载队列与推送通知,一个开源免费的手机App 就管理了全部影视库,还顺手解决了多实例、跨设备、自动化这些进阶需求。如果你是 Radarr / Sonarr 用户,这大概是目前 iOS 上最值得一试的影视库管理工具。