Lidarr Integration

Full music management from your phone: browse artists and albums, add artists, search releases, manage the download queue, wanted lists, tasks, system health, and storage.

3 min read 64 views

Overview

JellyWatch ships a full Lidarr management screen for your music collection, not just a read-only view. It is organized into 6 tabs you switch between with the chips at the top: Artists, Queue, Wanted, Tasks, System, and Storage.

Setup

  1. Add an external service of type Lidarr.
  2. Enter the Lidarr URL and API key (found in Lidarr -> Settings -> General).
  3. Optionally enable self-signed certificates, dual URL mode, and custom headers.

Full Setup (starting from enabling authentication and getting the API key)

  1. Access Lidarr Settings Open the Lidarr web UI (http://your-server-ip:8686). Go to Settings -> General.

  2. Enable Authentication (recommended) Set Authentication to Forms or Basic. Enter a username and password if prompted and save.

  3. Generate / Copy API Key In the same General page, scroll to the Security section. Copy the API Key (click the eye icon if hidden).

  4. Add Lidarr to JellyWatch In JellyWatch go to Services -> Add Service. Select type Lidarr. Enter:

    • Name: e.g. "Home Lidarr"
    • URL: http://your-server-ip:8686 (use https:// if you have SSL)
    • API Key: paste the key from step 3 Tap Test Connection -> should say "Connected". Save.

Done! Lidarr is now connected to JellyWatch/EmbyWatch.

Artists Tab

  • Grid or list view of every artist with artwork and album counts.
  • Search your library by artist name.
  • Sort by name, album count, or date added (ascending or descending).
  • Add an artist: search by name, pick a root folder and quality profile, then add.
  • Delete an artist with or without its files.
  • Tap an artist to open its detail page with artwork and the list of albums.
  • Tap an album to view its detail page with the track listing and download status.

Release Search and Download

  • Automatic search asks Lidarr to grab the best release for an album.
  • Manual search opens a releases dialog listing available releases with indexer, size, seeders/leechers, and quality.
  • Pick a release to download it manually.
  • Search all missing and Search all cutoff unmet trigger bulk searches from the Wanted tab.

Queue Tab

  • View all active album/track downloads with progress, size, and status.

Wanted Tab

  • Missing: monitored albums with no file (paginated).
  • Cutoff Unmet: albums below the quality cutoff (paginated).

Tasks Tab

  • List the Lidarr scheduled tasks and trigger commands.

System Tab

  • System status: version and instance details.
  • Health checks reported by Lidarr.
  • Restart or shut down the Lidarr instance.

Storage Tab

  • Per-root-folder disk usage: free space and total space.

Calendar and Dashboard Integration

Lidarr feeds into the Calendar screen, showing:

  • Upcoming album release dates (physical and digital).

The calendar data also powers the Lidarr Upcoming dashboard carousel, which can be reordered or hidden from Settings -> Menu Customization -> Dashboard Sections.

Notes

  • Works with the Lidarr v1 API (default port 8686).
  • For remote access, use a VPN or reverse proxy. Never expose the API key publicly.
  • Multiple Lidarr instances can be connected.
Last updated on ·516 words