sacad 3.0.0

Smart Automatic Cover Art Downloader
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# SACAD

## Smart Automatic Cover Art Downloader

[![CI status](https://img.shields.io/github/actions/workflow/status/desbma/sacad/ci.yml)](https://github.com/desbma/sacad/actions)
[![crates.io version](https://img.shields.io/crates/v/sacad)](https://crates.io/crates/sacad)
[![AUR version](https://img.shields.io/aur/version/sacad.svg?style=flat)](https://aur.archlinux.org/packages/sacad/)
[![License](https://img.shields.io/github/license/desbma/sacad.svg?style=flat)](https://github.com/desbma/sacad/blob/master/LICENSE)

---

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

The previous Python version can be found in the [2.x branch](https://github.com/desbma/sacad/tree/2.x).

---

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](https://github.com/desbma/sacad/releases).

### From [`crates.io`](https://crates.io/)

```bash
cargo install sacad
```

### From source

You need a Rust build environment for example from [rustup](https://rustup.rs/).

Run in the current repository:

```bash
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:

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

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

```bash
sacad_r library_directory 600 AlbumArt.jpg
```

## License

[Mozilla Public License Version 2.0](https://www.mozilla.org/MPL/2.0/)