https://github.com/ruddarr/app
A native iOS companion app for Radarr and Sonarr instances.
https://github.com/ruddarr/app
radarr sonarr swift swiftui
Last synced: about 1 month ago
JSON representation
A native iOS companion app for Radarr and Sonarr instances.
- Host: GitHub
- URL: https://github.com/ruddarr/app
- Owner: ruddarr
- License: mit
- Created: 2024-01-12T02:37:51.000Z (over 1 year ago)
- Default Branch: develop
- Last Pushed: 2025-04-27T18:22:56.000Z (about 1 month ago)
- Last Synced: 2025-04-27T19:27:43.789Z (about 1 month ago)
- Topics: radarr, sonarr, swift, swiftui
- Language: Swift
- Homepage: https://apps.apple.com/app/ruddarr/id6476240130
- Size: 18.4 MB
- Stars: 260
- Watchers: 7
- Forks: 15
- Open Issues: 32
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-arr - Ruddarr - Ruddarr is a beautifully designed, open source, iOS/iPadOS companion app for Radarr and Sonarr instances written in SwiftUI. (Mobile Apps)
README
# Ruddarr
Ruddarr is a beautifully designed, open source, companion app for Radarr and Sonarr instances written in SwiftUI.
- [App Store](https://apps.apple.com/app/ruddarr/id6476240130)
- [Join the Discord](https://discord.gg/UksvtDQUBA)
## 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
## Localization
Help [translate Ruddarr](https://crowdin.com/project/ruddarr) into any language. Check the `#translators` channel [on Discord](https://discord.gg/UksvtDQUBA). Unfortunately, [some messages](https://github.com/ruddarr/app/issues/433) cannot be translated by Ruddarr.
## Notifications
The code of the notification service is powered by a Cloudflare Worker and also [open source](https://github.com/ruddarr/apns-worker).
## 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`](https://github.com/ruddarr/app/blob/develop/Ruddarr/Dependencies/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` and `Push Notification` capabilities and skipping the next steps, or **b)** continuing on and removing the capabilities from:
```
Ruddarr → Signing & Capabilities → Targets → Ruddarr
```
Then uncomment the CloudKit mock in `Ruddarr::init()`:
```swift
dependencies.cloudkit = .mock
```
Lastly, change `@CloudStorage` to `@AppStorage` in `AppSettings`:
```diff
- @CloudStorage("instances") var instances: [Instance] = []
+ @AppStorage("instances") var instances: [Instance] = []
```
That's it. Select a run destination and build it.
### Sentry Symbols
Create a `.sentryclirc` file:
```yml
[auth]
token=sntrys_eyJp...
```
### Reset Xcode
```bash
sudo xcode-select -s /Applications/Xcode.app
xcrun simctl --set previews delete all
```