sacad
| Crates.io | sacad |
| lib.rs | sacad |
| version | 3.0.0-beta.6 |
| created_at | 2026-01-09 22:41:57.022754+00 |
| updated_at | 2026-01-14 11:08:42.975831+00 |
| description | Smart Automatic Cover Art Downloader |
| homepage | |
| repository | https://github.com/desbma/sacad |
| max_upload_size | |
| id | 2033086 |
| size | 250,740 |
(desbma)
documentation
README
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
From source
You need a Rust build environment for example from rustup.
Run in the current repository:
cargo install --path .
From crates.io
cargo install sacad --version '>=3.0.0-b.1'
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