Skip to content

Lidarr Setup

Complete guide for adding Lidarr to OmniFetch.

Prerequisites

  • Lidarr v1.0+ installed and running
  • Access to Lidarr web interface
  • Lidarr API key

Adding Lidarr to OmniFetch

Step 1: Locate Your API Key

  1. Open your Lidarr 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 Lidarr
Add Service Lidarr
Add Service Lidarr

Step 3: Configure Connection

Enter your Lidarr connection details:

Server Address

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

Port

  • Default Lidarr port: 8686
  • 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 Lidarr
  • Ensure no extra spaces before or after

Connection Examples

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

Step 4: Advanced Settings (Optional)

For additional configuration options, tap Advanced Settings:

Advanced Settings Lidarr
Advanced Settings Lidarr

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 Lidarr 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
  • ✅ Lidarr version compatible

If test fails:

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

Step 6: Save Configuration

  1. Once test passes, tap "Save"
  2. Lidarr 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. Lidarr webhooks are configured automatically

Configure Refresh Intervals

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

Set Notification Preferences

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

Push Notification Setup

For detailed webhook and notification configuration for Lidarr, see the Lidarr 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 Lidarr

  10. Verify push notification received

  11. Review Calendar:

  12. Check upcoming releases
  13. Verify data accuracy

Next Steps