Art-downloader

Download artist art based on their MBID. This node.js program reads a JSON-based music file as used by JSMusicDB, whose structure is based on scanner.py. For each found artist both fanart and Deezer are queried to find art for the artist. If a lot of artists need to be queried a rate limit can occur. If that is the case the program will sleep for 1 minute and then try again. Please be patient while we do our best to find all the art.

Config

The following variables should be set in .env:

• LASTFMAPIKEY: your last.fm API key. Used to fetch metadata about the found artist. Mainly used for rapid MBID lookup.
• FANARTAPIKEY: your fanart API key. Used for looking up missing art at fanart.
• OUTPUT_FOLDER: optional the output folder for cache and status files.
• ART_FOLDER: optional the output folder for the art images; defaults to OUTPUT_FOLDER/art/.
• MUSIC_FILE: optional full path to your JSMusicDB compatible music file; defaults to ./src.
• SOURCE_BASE: optional the base folder to which the paths in MUSIC_FILE resolve. Used when trying to write art to the source folders.

Options

• --skipArtists will skip all processing for artists.
• --skipAlbums will skip all processing for albums.
• --turbo only download art for newly fetched MBIDs.
• --printArtistsWithoutArt will print a list of all artists and their MBID for which no art is found.
• --printArtists will print a list of all artists and their MBID.
• --printAlbums will print a list of all albums and the URL to the source of the art
• --printAlbumsWithoutArt will print a list of all albums that have no source for their MBID
• --updateLib will extend the source MUSIC_FILE with the MBIDs
• --writeSource will write cover.[jpg|png|webp|...] files in the folder per album found in SOURCE_BASE
• --daemon output minimal progress to output folder in the file progress.txt

Tip: you can export the output of --printArtists and --printAlbums to a file. For example: npm run start --printAlbums > albums.txt

Output

Art is downloaded to ART_FOLDER or ./output/art/ if ART_FOLDER is not specified in .env.

The output logs are stored in ./output and will contain 2 parts:

• artists.json a map of all cached artist <> MBID pairs found. This is used to speed up the process the next time you run the application.
• albums.json a map of all cached albums <> {MBID, URL} pairs found. Since last.fm has the album art and does the MBID lookup the data is stored in one go.
• artists-without-art.json a map of all artists <> MBID for which no art could be found, neither cached nor online. You can use the MBID to save your art for example.