Skip to content

ruddarr/app

Repository files navigation

Ruddarr

Ruddarr is a beautifully designed, open source, companion app for Radarr and Sonarr instances written in SwiftUI.

Features

  • Manage movies and TV series
  • Browse upcoming releases in the calendar
  • Receive fine-grained notifications
  • View activity queue tasks and history events
  • Switch between multiple instances
  • Customize the app color scheme and appearance
  • Synchronize settings/instances between devices (iCloud)
  • Automate actions using Siri Shortcuts
  • Connect to reverse proxies using custom HTTP headers
  • Use Spotlight search to quickly jump to media
  • Fully localized, ready to be translated

Screenshots

Movies library Series details Calendar Discover movies

Localization

Help translate Ruddarr into any language. Check the #translators channel on Discord. Unfortunately, some messages cannot be translated by Ruddarr.

Notifications

The code of the notification service is and also open source.

URL Schemes

Ruddarr supports the ruddarr:// URL Scheme to open specific tabs, items or perform actions. All supported schemes are listed in the QuickActions.swift

Development

To build the app locally Xcode must be signed into an Apple Account:

Xcode → Settings → Accounts

Next, select the Apple Account's team for the Ruddarr and NotificationService targets:

Ruddarr → Signing & Capabilities → Targets → {target} -> Signing -> Team

Now choose between a) creating a provisioning profile on your account for the iCloud, App Groups and Push Notification capabilities and skipping the next steps, or b) continuing on and removing the capabilities from both targets (the NotificationService target only has App Groups):

Ruddarr → Signing & Capabilities → Targets → Ruddarr
Ruddarr → Signing & Capabilities → Targets → NotificationService

Then uncomment the CloudKit mock in Ruddarr::init():

dependencies.cloudkit = .mock

Note

Instances and other settings are stored in the group.com.ruddarr App Group so app extensions can read them. When using your own bundle identifier, update Ruddarr.group in Ruddarr.swift and the App Groups entry in both the Ruddarr and NotificationService entitlements to match.

That's it. Select a run destination and build it.

Sentry Symbols

Create a .sentryclirc file:

[auth]
token=sntrys_eyJp...

Reset Xcode

sudo xcode-select -s /Applications/Xcode.app
xcrun simctl --set previews delete all

About

A native iOS companion app for Radarr and Sonarr instances.

Topics

Resources

License

Security policy

Stars

619 stars

Watchers

7 watching

Forks

Sponsor this project

  •  

Contributors