Ruddarr完全指南:开源免费的Radarr与Sonarr手机伴侣App,一个应用管理全部影视库

原创2026-11-01 14:29:591,448 阅读

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 版本:

Ruddarr 默认应用图标,Radarr 与 Sonarr 的手机伴侣App

场景 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 分钟:

  1. 打开 Ruddarr → 进入 Settings → Instances,点击新增实例
  2. 填写实例地址与 API Key:即你 Radarr / Sonarr 的访问地址(如 http://192.168.1.10:7878)和 API 密钥
  3. 保存,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 图标:在设置中一键更换桌面图标,融入各种风格的图标主题

Ruddarr Warp 彩色应用图标,一个应用管理全部影视库

其中部分个性图标(如 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 上最值得一试的影视库管理工具。

登录后查看全文
app