thrash.dev

docs / providers / lidarr

Providers · chapters · 06 of 25

← Yafmp manual

  1. Local Files
  2. Plex
  3. Navidrome
  4. Jellyfin
  5. Bandcamp
  6. Lidarr
  7. Apple Music
  8. Spotify
  9. SoundCloud
  10. YouTube Music
  11. SiriusXM
  12. Radio
  13. Podcasts
  14. AirPlay
  15. Chromecast
  16. MusicBrainz
  17. Discogs
  18. Labels
  19. Releases
  20. Last.fm
  21. ListenBrainz
  22. Connect
  23. Home Assistant
  24. MCP server
  25. DJ

Lidarr

Browse your Lidarr collection and play it through Plex; see wanted albums, monitor them and start searches.

facts

status
beta
kind
source
on by default
no
needs
Lidarr server and its API key, Plex, with Lidarr's music folder in its library
platforms
iPhone, iPad, Mac, Vision Pro

Description

Lidarr shows your Lidarr collection in Yafmp’s library panel: artists, their albums and the tracks, with Lidarr’s numbering and MusicBrainz ids. Lidarr manages files but does not stream them, so playback goes through Plex. Yafmp matches each Lidarr file to the same file in Plex by its path below the music folder, and the track then plays like any Plex track.

The library shows Artists, in A–Z folders, and Wanted, the newest 200 monitored albums with missing tracks. Artist and album rows show how many of their tracks have files. An album that is not monitored says so. Search finds artists by name.

Right-click (or long-press) an album for Search for Album and Monitor or Stop Monitoring.

Lidarr is in the Apple edition only, and not on Apple TV. It is off by default.

Requirements

  • A Lidarr server that the device can reach, and its API key.
  • Plex signed in in Yafmp.
  • Lidarr’s music folder in your Plex music library, with the same folders and file names below it.

Setup

  1. Open Preferences → Plugins → Lidarr and turn on Enabled.
  2. In Address, enter Lidarr’s address, for example http://lidarr.local:8686.
  3. In Lidarr, open Settings → General and copy the API key. Paste it into API Key.
  4. Choose Save and Connect.
  5. When Status shows Lidarr and its version, the Lidarr rows appear in the library.

Settings

SettingDefaultWhat it does
EnabledoffTurns the Lidarr plugin on.
Address—Lidarr’s address, with http:// or https://.
API Key—The key from Lidarr → Settings → General. Leave it empty to keep the saved one.
Save and Connect—Saves the fields and checks them against Lidarr.
Status—Lidarr’s name and version once connected, or what went wrong. Read-only.

The API key is kept in the system keychain. The address and key are shared with your other Apple devices through iCloud Keychain.

Limits

  • Nothing plays without Plex. A track with no file in Lidarr shows Missing; a track Plex does not have shows Not in Plex. Neither can be played.
  • Wanted lists the newest 200 albums. When there are more, the last row says how many.
  • Search finds artists only, and shows the first 20.
  • Search for Album starts a search in Lidarr. Yafmp does not show its progress.
  • Plain http:// works only for .local names and IP addresses; use https for anything else.

Troubleshooting

ProblemWhyWhat to do
The Lidarr section is missingLidarr is off by defaultTurn it on in Preferences → Plugins → Lidarr.
“Set Lidarr’s address and API key in Preferences → Plugins → Lidarr.”The address or the key is missingEnter both and choose Save and Connect.
“Lidarr rejected the API key (Lidarr → Settings → General → API Key).”The key is wrongCopy the key from Lidarr again.
“Lidarr plays through Plex: sign in to Plex first.”Plex is not signed inSet up Plex.
“Plex doesn’t have this album yet (it may still be scanning).”Plex has not found the filesLet Plex finish its scan, or refresh Plex, then open the album again.
Every track says Not in PlexThe paths below the music folder differ between Lidarr and PlexPoint a Plex music library at Lidarr’s music folder.
An error stays at the top of the sectionThe last Search or Monitor action failed, or Lidarr can’t be reachedChoose Retry there.