Providers · chapters · 06 of 25
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
- Open Preferences → Plugins → Lidarr and turn on Enabled.
- In Address, enter Lidarr’s address, for example
http://lidarr.local:8686. - In Lidarr, open Settings → General and copy the API key. Paste it into API Key.
- Choose Save and Connect.
- When Status shows Lidarr and its version, the Lidarr rows appear in the library.
Settings
| Setting | Default | What it does |
|---|---|---|
| Enabled | off | Turns 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.localnames and IP addresses; use https for anything else.
Troubleshooting
| Problem | Why | What to do |
|---|---|---|
| The Lidarr section is missing | Lidarr is off by default | Turn it on in Preferences → Plugins → Lidarr. |
| “Set Lidarr’s address and API key in Preferences → Plugins → Lidarr.” | The address or the key is missing | Enter both and choose Save and Connect. |
| “Lidarr rejected the API key (Lidarr → Settings → General → API Key).” | The key is wrong | Copy the key from Lidarr again. |
| “Lidarr plays through Plex: sign in to Plex first.” | Plex is not signed in | Set up Plex. |
| “Plex doesn’t have this album yet (it may still be scanning).” | Plex has not found the files | Let Plex finish its scan, or refresh Plex, then open the album again. |
| Every track says Not in Plex | The paths below the music folder differ between Lidarr and Plex | Point a Plex music library at Lidarr’s music folder. |
| An error stays at the top of the section | The last Search or Monitor action failed, or Lidarr can’t be reached | Choose Retry there. |