Skip to content

Initial Setup

Complete guide for first-time OmniFetch app configuration.

First Launch

When you first open OmniFetch, you'll go through an initial setup process.

1. Welcome Screen

  • Tap Enable iCloud Sync to begin setup
Initial Setup Welcome Screen Light ModeInitial Setup Welcome Screen Dark Mode
  • You can Tap not now if you want to use local only storage

iCloud Access

  • Purpose: Sync configurations across devices
  • Required: Optional but recommended
  • Action: Allow access for CloudKit sync

3. Initial Configuration

After permissions are granted:

  1. Choose Setup Mode:
  2. Quick Setup - Add your first service immediately
  3. Manual Setup - Configure app settings first

  4. Import Configuration - Restore from backup (if available)

  5. Set Basic Preferences:

  6. Display name for your setup
  7. Default refresh intervals
  8. Notification preferences

Adding Your First Service

Quick Add Process

  1. Tap Add Service from the main screen
  2. Choose your service type:
  3. Sonarr (TV Shows)
  4. Radarr (Movies)
  5. Lidarr (Music)
  6. Jellyseerr (Requests)

  7. SABnzbd (Downloads)

  8. Enter service details:

  9. URL: Service address (local or remote)

  10. API Key: From service settings

  11. Test and save the connection

Connection Testing

OmniFetch automatically tests:

  • Network connectivity
  • API key validity
  • Service version compatibility
  • Available endpoints

Enable Notifications

To get the most out of OmniFetch, enable notifications:

Permission Setup Steps

  1. Allow Notifications: Tap "Allow" when prompted for notification permissions
  2. Enable in Settings: Toggle notifications on in the OmniFetch settings
  3. Confirm Setup: Tap "OK" to complete the notification setup process

1. Configure Push Notifications

  1. Go to Settings → Notification Settings
  2. Toggle on notifications for your configured services
  3. Test notifications to ensure they're working properly

2. Notification Types

  • Service Health: Get alerted when services go offline or have issues
  • Download Complete: Know when your media finishes downloading
  • Request Updates: Stay informed about Jellyseerr request status changes
  • System Alerts: Important updates about your media stack

Post-Setup Checklist

After initial setup, verify:

  • Notifications are working (test from settings)
  • At least one service is configured
  • Service shows green status indicator
  • CloudKit sync is enabled (if desired)
  • Background refresh is enabled
  • Beta key is saved (if applicable)

Next Steps