Media Organizer Integrations

Media organizer integrations (commonly called “*arr” applications) automate your media management by handling searches, downloads, and organization of your content.

Supported Organizers

Sonarr

TV show PVR for Usenet and torrents

Radarr

Movie collection manager

Lidarr

Music collection organizer

Readarr

eBook and audiobook manager

Prowlarr

Indexer manager for all *arr apps

Sonarr

Automate TV show downloads and organization with calendar integration.

Configuration

url

string

required

Base URL of Sonarr (e.g., http://sonarr.local:8989)

apiKey

string

required

Sonarr API key from Settings → General → Security

Finding Your API Key

Open Sonarr

Navigate to your Sonarr web interface

Settings

Click Settings (wrench icon) in the left sidebar

Show Advanced

Toggle Show Advanced at the top

General Tab

Go to the General tab

Copy API Key

Scroll to Security section and copy the API Key

Available Features

Calendar Events

Display upcoming TV show episodes:

Episode air dates and times
Show title and episode name
Season and episode numbers (S01/E05)
Series overview and description
Episode poster/screenshot images
Links to Sonarr and IMDb
Monitored vs unmonitored status

Widget: Calendar Widget with Sonarr integrationAPI Method: getCalendarEventsAsync(start, end, includeUnmonitored)

Episode Images

Smart image selection for episodes:Priority order:

Episode screenshot
Series poster
Series banner
Series fanart

Images maintain 7:12 aspect ratio with season/episode badge.

Calendar Event Properties

{
  title: "Episode Title",
  subTitle: "Series Name",
  description: "Series overview",
  startDate: Date,
  endDate: null,
  image: {
    src: "screenshot-url",
    aspectRatio: { width: 7, height: 12 },
    badge: { color: "red", content: "S01/E05" }
  },
  indicatorColor: "blue",
  links: [
    { name: "Sonarr", href: "sonarr-url" },
    { name: "IMDb", href: "imdb-url" }
  ]
}

Example Configuration

{
  "name": "Sonarr",
  "url": "http://192.168.1.100:8989",
  "secrets": {
    "apiKey": "your-sonarr-api-key-here"
  }
}

Radarr

Manage your movie collection with automated downloads and organization.

Configuration

url

string

required

Base URL of Radarr (e.g., http://radarr.local:7878)

apiKey

string

required

Radarr API key from Settings → General → Security

Finding Your API Key

Same process as Sonarr:

Settings → General (with Advanced shown)
Scroll to Security section
Copy the API Key

Available Features

Calendar Events

Track movie releases and availability:

Movie release dates (theater or digital)
Movie posters and backdrop images
Title, tagline, and overview
Links to Radarr and external sites
Monitored status tracking

Widget: Calendar Widget with Radarr integration

Movie Images

High-quality movie artwork:Priority order:

Movie poster
Movie fanart/backdrop
Movie banner

Optimized for display in calendar widgets.

Example Configuration

{
  "name": "Radarr",
  "url": "http://192.168.1.100:7878",
  "secrets": {
    "apiKey": "your-radarr-api-key-here"
  }
}

Lidarr

Automate music collection management.

Configuration

url

string

required

Base URL of Lidarr (e.g., http://lidarr.local:8686)

apiKey

string

required

Lidarr API key from Settings → General → Security

Available Features

Calendar Events: Track album releases
Artist Monitoring: Monitor favorite artists for new releases
Album Images: Album art and artist photos
Import Lists: Automatic artist/album imports

Example Configuration

{
  "name": "Lidarr",
  "url": "http://192.168.1.100:8686",
  "secrets": {
    "apiKey": "your-lidarr-api-key-here"
  }
}

Readarr

Organize eBooks and audiobooks.

Configuration

url

string

required

Base URL of Readarr (e.g., http://readarr.local:8787)

apiKey

string

required

Readarr API key from Settings → General → Security

Available Features

Calendar Events: Track book release dates
Author Monitoring: Follow authors for new releases
Book Covers: Display book cover artwork
Metadata: Rich book information and descriptions

Example Configuration

{
  "name": "Readarr",
  "url": "http://192.168.1.100:8787",
  "secrets": {
    "apiKey": "your-readarr-api-key-here"
  }
}

Prowlarr

Centralized indexer management for all your *arr applications.

Configuration

url

string

required

Base URL of Prowlarr (e.g., http://prowlarr.local:9696)

apiKey

string

required

Prowlarr API key from Settings → General → Security

Available Features

Indexer Management

Monitor and control your indexers:

List all configured indexers
Indexer status (active/inactive)
Enabled/disabled state
Indexer URLs
Test all indexers at once

Widget: Indexer Manager WidgetAPI Methods: getIndexersAsync(), testAllAsync()

Indexer Status

Real-time health monitoring:

{
  id: number,
  name: string,
  url: string,
  enabled: boolean,
  status: boolean  // true = healthy, false = failing
}

Status checks failures and recent errors from Prowlarr.

Test All Indexers

Prowlarr integration can test all indexers simultaneously:

await integration.testAllAsync();

Useful for:

Verifying indexer connectivity
Checking API keys
Troubleshooting search issues

Example Configuration

{
  "name": "Prowlarr",
  "url": "http://192.168.1.100:9696",
  "secrets": {
    "apiKey": "your-prowlarr-api-key-here"
  }
}

Common Configuration

API Version

All modern *arr applications use API v3:

Sonarr: /api/v3/*
Radarr: /api/v3/*
Prowlarr: /api/v1/*

Ensure your *arr applications are up-to-date. Very old versions using API v1/v2 may not work properly.

Base URL Configuration

If running behind a reverse proxy with a path:

# Nginx example
location /sonarr {
    proxy_pass http://sonarr:8989;
}

Configure base URL in Sonarr:

Settings → General → URL Base: /sonarr
Use full URL in Homarr: https://yourdomain.com/sonarr

Authentication

*arr apps support two auth methods:

API Key (Recommended)
Basic Auth

Use API key for service-to-service communication:

No session management needed
Won’t expire or require refresh
Specific to the application
Can be regenerated if compromised

Some setups use HTTP Basic Auth at proxy level:

Add to URL: http://user:[email protected]:8989
Or configure at reverse proxy
Still requires API key for actual API calls

Comparison

Feature	Sonarr	Radarr	Lidarr	Readarr	Prowlarr
Media Type	TV	Movies	Music	Books	N/A
Calendar	✅	✅	✅	✅	❌
Monitoring	✅	✅	✅	✅	❌
Indexers	✅	✅	✅	✅	✅ (Manages)
Download Client	✅	✅	✅	✅	❌
Metadata	TheTVDB	TMDB	MusicBrainz	GoodReads	N/A
Default Port	8989	7878	8686	8787	9696

All media organizers work with the Calendar widget:

Add Calendar Widget

Edit Mode → Add Widget → Calendar

Select Integrations

Choose one or more *arr integrations to display

Configure View

Set date range, view mode (month/week/day)

Customize Display

Enable/disable images, adjust size, set colors

Multi-Integration Calendar

Display events from multiple organizers:

[
  { type: 'sonarr', color: 'blue' },
  { type: 'radarr', color: 'yellow' },
  { type: 'lidarr', color: 'green' },
  { type: 'readarr', color: 'purple' }
]

Each integration’s events appear with distinct colors.

Image Priority System

*arr integrations use smart image selection:

Sonarr Priority

Screenshot (episode-specific)
Poster (series)
Banner (series)
Fanart (series)
Headshot (if actor-focused)
Clearlogo (overlay)

Radarr Priority

Poster (movie)
Fanart (backdrop)
Banner
Clearlogo

Images are fetched via remote URLs with fallback handling.

Troubleshooting

”Unauthorized” Error

Verify API key is correct (copy again from settings)
Check “Show Advanced” is enabled to see API key
Ensure API key hasn’t been regenerated
Try creating a new API key if issues persist

Calendar Not Showing Events

Verify items are monitored in the *arr app
Check date range includes upcoming releases
Ensure includeUnmonitored is set correctly
Look for errors in Homarr logs

Connection Timeout

Verify *arr app is accessible from Homarr network
Check firewall rules
Test with curl: curl -H "X-Api-Key: your-key" http://sonarr:8989/api/v3/calendar
Increase timeout in Homarr settings if needed

Images Not Loading

Images are fetched from remote URLs
Check network connectivity to image CDNs
Verify image URLs in *arr app (Settings → Media Management)
Some images may be blocked by firewall/proxy

Best Practices

*Sync All arr Apps with Prowlarr: Configure all your media organizers in Prowlarr to sync indexers automatically.

Separate Instances: Run separate instances for different quality profiles (4K Radarr, 1080p Radarr)
Monitor New Releases: Enable calendar widget to track upcoming content
Health Checks: Use Prowlarr widget to monitor indexer status
Backup API Keys: Store API keys securely (password manager)
Regular Updates: Keep *arr applications updated for latest features

Next Steps

Download Clients

Connect download clients to your *arr apps

Media Servers

Link media servers to view content

Calendar Widget

Customize your media calendar display

Media Servers

Connect to Plex, Jellyfin, or Emby

Get Started

Core Features

Configuration

Integrations

Guides

​Supported Organizers

Sonarr

Radarr

Lidarr

Readarr

Prowlarr

​Sonarr

​Configuration

​Finding Your API Key

​Available Features

​Calendar Event Properties

​Example Configuration

​Radarr

​Configuration

​Finding Your API Key

​Available Features

​Example Configuration

​Lidarr

​Configuration

​Available Features

​Example Configuration

​Readarr

​Configuration

​Available Features

​Example Configuration

​Prowlarr

​Configuration

​Available Features

​Test All Indexers

​Example Configuration

​Common Configuration

​API Version

​Base URL Configuration

​Authentication

​Comparison

​Calendar Widget Integration

​Multi-Integration Calendar

​Image Priority System

​Sonarr Priority

​Radarr Priority

​Troubleshooting

​”Unauthorized” Error

​Calendar Not Showing Events

​Connection Timeout

​Images Not Loading

​Best Practices

​Next Steps

Download Clients

Media Servers

Calendar Widget

Media Servers

Build docs developers (and LLMs) love

Supported Organizers

Sonarr

Configuration

Finding Your API Key

Available Features

Calendar Event Properties

Example Configuration

Radarr

Configuration

Finding Your API Key

Available Features

Example Configuration

Lidarr

Configuration

Available Features

Example Configuration

Readarr

Configuration

Available Features

Example Configuration

Prowlarr

Configuration

Available Features

Test All Indexers

Example Configuration

Common Configuration

API Version

Base URL Configuration

Authentication

Comparison

Calendar Widget Integration

Multi-Integration Calendar

Image Priority System

Sonarr Priority

Radarr Priority

Troubleshooting

”Unauthorized” Error

Calendar Not Showing Events

Connection Timeout

Images Not Loading

Best Practices

Next Steps