SACAD

Smart Automatic Cover Art Downloader

Since version 3.0, this tool has been completely rewritten in Rust.

The previous Python version can be found in the 2.x branch.

SACAD is a multi platform command line tool to download album covers without manual intervention, ideal for integration in scripts, audio players, etc.

SACAD also provides a second command line tool, sacad_r, to scan a music library, read metadata from audio tags, and download missing covers automatically, optionally embedding the image into audio audio files.

Features

• Can target specific image size, and find results for high resolution covers
• Support JPEG and PNG formats
• Customizable output: save image along with the audio files / in a different directory named by artist/album / embed cover in audio files...
• Currently support the following cover sources:
• CoverArtArchive (MusicBrainz)
• Deezer
• Discogs
• Last.fm
• Itunes
• Smart sorting algorithm to select THE best cover for a given query, using several factors: source reliability, image format, image size, image similarity with reference cover, etc.
• Automatically crunch PNG images (can save 30% of file size without any loss of quality)
• Cache search data locally for faster future search
• Automatically convert/resize image if needed
• Multi platform (Windows/Mac/Linux)

Installation

Binaries

Windows, Mac OS, and Linux binaries are available on GitHub.

From crates.io

cargo install sacad

From source

You need a Rust build environment for example from rustup.

Run in the current repository:

cargo install --path .

Command line usage

Two tools are provided: sacad to search and download one cover, and sacad_r to scan a music library and download all missing covers.

Run sacad -h / sacad_r -h to get full command line reference.

Examples

To download the cover of Master of Puppets from Metallica, to the file AlbumArt.jpg, targeting ~ 600x600 pixel resolution:

sacad "metallica" "master of puppets" 600 AlbumArt.jpg

To download covers for your library with the same parameters as previous example:

sacad_r library_directory 600 AlbumArt.jpg

License

Mozilla Public License Version 2.0