Skip to content

Sonarr Setup

Complete guide for adding Sonarr to OmniFetch.

Prerequisites

  • Sonarr v3.0+ installed and running
  • Access to Sonarr web interface
  • Sonarr API key

Adding Sonarr to OmniFetch

Step 1: Locate Your API Key

  1. Open your Sonarr web interface
  2. Navigate to Settings → General
  3. Under the Security section, find API Key
  4. Click Show if the key is hidden
  5. Copy the API key to your clipboard

API Key Security

Keep your API key secure. Never share it publicly or commit it to version control.

Step 2: Add Service in OmniFetch

  1. Open OmniFetch app
  2. Go to Settings
  3. Tap "Add Service"
  4. From Service Type dropdown, select Sonarr
Add Service Sonarr
Add Service Sonarr

Step 3: Configure Connection

Enter your Sonarr connection details:

Server Address

  • Enter hostname or IP address only
  • Examples:
  • Remote: sonarr.mydomain.com
  • Local: 192.168.1.100
  • Docker: sonarr (container name)

Port

  • Default Sonarr port: 8989
  • Change if using custom port

Use HTTPS

  • Enable if using SSL/TLS
  • Most local installations use HTTP

API Key

  • Paste the API key you copied from Sonarr
  • Ensure no extra spaces before or after

Connection Examples

  • Local HTTP: Server Address: 192.168.1.100, Port: 8989, HTTPS: Off
  • Remote HTTPS: Server Address: sonarr.mydomain.com, Port: 443, HTTPS: On
  • Docker: Server Address: sonarr, Port: 8989, HTTPS: Off

Step 4: Advanced Settings (Optional)

For additional configuration options, tap Advanced Settings:

Advanced Settings Sonarr
Advanced Settings Sonarr

Advanced Options Include:

  • Custom timeout settings
  • SSL certificate validation
  • Request headers
  • Base URL path
  • Authentication method

Advanced Settings

Most users can skip advanced settings. Only configure these if you have specific requirements or custom Sonarr setup.

Step 5: Test Connection

  1. Tap "Test Connection"
  2. Wait for the test to complete
  3. Look for the success message

If test succeeds:

  • ✅ Connection established
  • ✅ API key valid
  • ✅ Sonarr version compatible

If test fails:

  • ❌ Check URL format and accessibility
  • ❌ Verify API key is correct
  • ❌ Ensure Sonarr is running

Step 6: Save Configuration

  1. Once test passes, tap "Save"
  2. Sonarr will appear in your services list
  3. Initial data sync will begin

Post-Setup Configuration

Enable Notifications (Beta)

If you have beta access:

  1. Go to Settings → Notification Settings → Push Notifications
  2. Enter your Private Beta Key
  3. Save to enable webhook notifications
  4. Sonarr webhooks are configured automatically

Configure Refresh Intervals

  1. Open Sonarr service in OmniFetch
  2. Tap settings icon
  3. Adjust refresh intervals:
  4. Queue: 5-15 minutes
  5. Calendar: 30-60 minutes
  6. Series: 60+ minutes

Set Notification Preferences

  1. Go to Sonarr notification settings
  2. Enable desired events:
  3. Episode Downloaded ✅
  4. Episode Grabbed
  5. Quality Upgraded
  6. Health Issues ✅
  7. Series Deleted

Push Notification Setup

For detailed webhook and notification configuration for Sonarr, see the Sonarr Webhooks Guide.

Verification Steps

After setup, verify everything works:

  1. Check Status Indicator:
  2. Green = Connected
  3. Yellow = Warning

  4. Red = Error

  5. View Queue:

  6. Pull to refresh

  7. Check active downloads

  8. Test Notifications:

  9. Trigger test from Sonarr

  10. Verify push notification received

  11. Review Calendar:

  12. Check upcoming episodes
  13. Verify data accuracy

Next Steps