-
-
Notifications
You must be signed in to change notification settings - Fork 28
Home
- The script connects to Lidarr to pull artist list.
- The connects to "https://musicbrainz.org" or a mirror (if configured) and pulls every release for each artist in your Lidarr instance and caches the data locally (only updates cache as needed).
- The script will pull your monitored/wanted album list out of Lidarr and begin processing it.
- When processing a wanted album, it will first look in the local cache to see if a Album URL for an online resource is already attached to the particular album. If found, it will use that link to process the download. If it is not found, it will attempt a fuzzy match search and download the first match it finds.
- If URL found, download the requested files, if not found, log it in the "notfound.log" file
- Notify Lidarr to scan and import the completed download
The naming is completely controlled by your Lidarr configuration upon successful import
Musicbrainz (https://musicbrainz.org) is a community managed database, while not perfect, it empowers users to be able to add/update/enhance it. Adding the music album (with url) to the relevant artist on Musicbrainz, will enable the script to automatically download the requested album.
Updating Musicbrainz means you are helping the world! If everyone in the community spent a small amount of time updating the database with the Music. Then everyone in the community would benefit from those updates. IE: User1 updates their favorite artist with new albums and User2 does the same thing for their favorite artist. Now both users can download music for both artists as a result of both putting in a little effort.
Musicbrainz is limited to 1 api query per second. So depending how many api requests are needed, it can take considerable time to build the initial cache. The only way to speed this up is to use a mirror and in that case, you can increase the ratelimit to a desired setting. Linuxserver.io conveniently provide a dockerized Musicbrainz mirror that you can self host for this purpose, for more info: https://hub.docker.com/r/linuxserver/musicbrainz/
Lidarr is automatically notified and will import files if it matches a release using its internal matching engine. Files that are not imported will be found in the download directory /downloads-amd/amd/import