@addasoft/art-downloader

Art-downloader

Download artist art based on their MBID. This node.js program reads a JSON-based music file as used by JSMusicDB, which structure is based on scanner.py. For each found artist both fanart and theaudiodb 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:

• MUSIC_FILE: full path to your JSMusicDB compatible music file; defaults to ./src.
• ART_FOLDER: the output folder for the art images; defaults to ./output/art/.
• 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.

Options

By default art for both artists and albums is handling. You can skip either by adding the command-line option --skip[Artists|Albums]=true. For example: --skipAlbums=true will skip all processing for albums.

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.