Mp3 Cover Art Downloader

Latest version

This is a brief guide to help you using Mp3 Cover Downloader First of all, click on Browse to select your mp3 folder: The program will show up some covers. Select the one you prefer and click 'Apply' to save it on the mp3 file. Mp3Tag Pro is a multifunctional MP3 tag editor that supports all popular formats. This mp3 tagger will not only import such tags as titles, artists, albums and others into your audio files but help to sort and rename your MP3 collection in no time.

Released:

Batch cover art downloader and embedder for audio files

Project description

THE PROBLEM

Missing cover art for large imported music libraries.

EXISTING SOLUTIONS

  1. Apple's Music App (and its predecessor iTunes) has a 'Get Album Artwork' feature, but it isn't reliable and doesn't actually embed cover art into your audio files. That means if you move your music library elsewhere, you'll be missing all your album artwork.

  2. Metadata utilities like Metadatics are great (and cheap if not free), but they can require a lot of manual interaction to go through each album and select artwork from search results. This can be forbidding for large libraries of thousands of albums.

THIS SOLUTION

This Python package will batch-update your entire library without manual interaction for each album.

It uses Apple Music's artwork, which is already standardized and high-quality. It also embeds the artwork directly into your audio files, so that it's independent of your player.

Supported formats (so far)

  • MP3
  • MP4 (.m4a)
  • FLAC
  • Ogg Vorbis
  • Opus

Requirements

  • Python 3.5 or greater
  • Python packages: mutagen

Installation on MacOS using Homebrew

And then to upgrade existing installations:

Usage

From the Command Line

if you omit path, it will scan the current working directory

Pro Tip: You can run with --test first, then browse/prune the downloaded artwork, then run again with --no_download to embed only the artwork you didn't prune.

Using external art sources

The external-art options allow you to fall back on local folder art.Some other scraping systems may have created cover art: for instance, someKodi scrapers create a 'cover.jpg' image in each album directory.

Specifying '--external-art-mode before' will use these existing images, and onlydownload images if there is no existing image. Specifying '--external-art-modeafter' will attempt to download artwork as usual, only falling back on theexisting images if the download is unable to locate new art.

The '--external-art-filename' option allows you to specify the filename(s) to usefor this existing folder art. It defaults to 'cover.jpg _albumcover.jpg folder.jpg', which are 3 filenames commonly used by other scraping programs. Youcan also use bracket formatting with the artist, album, and title fields:for instance, --external-art-filename '{artist}-{album}-cover.jpg' would createfilenames such as 'The Beatles-Abbey Road-cover.jpg'.

The '--art-dest-filename' option allows you to specify the filename used tostore downloaded files, for interoperability with other systems. You mustbe careful to avoid collisions between different albums: The default is'{artist} - {album}.jpg'. If you know that all of the albums you're runningagainst have their own directories and you are using '--art-dest-inline', then youcould use something more generic (such as 'cover.jpg').

Pro Tip: If you have a cover.jpg in each album directory, you can use:'--external-art-mode before --external-art-filename cover.jpg --art-dest-inline'and the local images will be used when present (avoiding network lookups).You could also specify '--art-dest-filename cover.jpg' if you want to store thenewly downloaded covers in a similar location (again, this is only sanein combination with --art-dest-inline, in cases where each album is stored ina separate directory).

From the Python Environment

  • OPTIONS is a dict of the same options listed for the commandline, e.g. --verbose -> {'verbose': True}
  • you can omit PATH_TO_AUDIO_LIBRARY to default to your current directory
  • your CoverFinder object keeps a list of files_processed, files_skipped, files_failed, files_invalid

How it works

  1. First, it recursively scans your provided folder for supported files.
  • Step 1 is skipped if you specified a single file instead of a folder.
  1. For each file without embedded artwork (or all files if --force is used), attempts to download from Apple Music based on artist and album metadata.
  • Step 2 is skipped if it had already downloaded (or attempted to download) the image file.
  • Step 2 is also skipped based on --no_download or --skip_* options.
  1. If artwork is found, it's embedded into the audio file.

Why do you download from Apple Music and not Google image search?

  1. Google's Image Search API requires a dev token (so does Apple Music's API, but not its public web query URL).
  2. Google search queries are heavily throttled.
  3. Apple Music's cover sizes are standardized and sufficiently large.

Troubleshooting

The artwork is embedded now, but Apple's Music App still won't show it.

Try re-importing one of your embedded files. If the re-imported version shows artwork, you need to reimport your music library. You can do this without losing your playlists as follows:

  1. File->Library->Export Library... and name your exported library file.
  2. Visit Music->Preferences...->Files and screenshot your options. You'll need to restore them later.
  3. Quit the app and relaunch while holding down the Option key.
  4. Choose 'Create Library...' and pick a new location.
  5. Visit Music->Preferences...->Files and restore your desired options.
  6. File->Library->Import Playlist... and choose your library file from step 1. (Yes, it's called 'Import Playlist...' but you actually use this to import your library.)

Step 6 will take a while.

The artwork appears in Apple's Music App but not my iOS device.

You'll have to unsync all your music and re-sync it again. Try it with a single file first.

Release historyRelease notifications | RSS feed

1.4.3

1.4.2

1.4.1

Mp3 Cover Art Downloader

1.4.0

1.3.11

1.3.10

1.3.9

1.3.8

1.3.7

1.3.6

1.3.5

1.3.4

1.3.3

1.3.2

1.3.1

1.3.0

1.2.1

1.2.0

1.1.0

1.0.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for get-cover-art, version 1.4.3
Filename, sizeFile typePython versionUpload dateHashes
Filename, size get_cover_art-1.4.3-py3-none-any.whl (14.8 kB) File type Wheel Python version py3 Upload dateHashes
Filename, size get_cover_art-1.4.3.tar.gz (14.2 kB) File type Source Python version None Upload dateHashes
Close

Best Mp3 Cover Art Downloader

Hashes for get_cover_art-1.4.3-py3-none-any.whl

Hashes for get_cover_art-1.4.3-py3-none-any.whl
AlgorithmHash digest
SHA2569f58f2f9772d6b187de61b6d40efaf90ea667ff690936caeb82aaa8607b3b5f5
MD51365a7d95a2e4b3e56fb9d60885b4156
BLAKE2-2564cec093ce60b1f6ed94763d4f51a9bb638fbb81788eef7b3f64255cd5ab09b52
CloseFree

Mp3 Cover Art Downloader

Hashes for get_cover_art-1.4.3.tar.gz

Mp3 Album Artwork Downloader

Hashes for get_cover_art-1.4.3.tar.gz
AlgorithmHash digest
SHA256c579d64fd52e60c59677a7c40fa08d7a3bcadb9bf98e9ba1a52109de84a64644
MD59fd1046c884cf816608b8d6091b41d7e
BLAKE2-256cd4725f15c256a93f6a40ec75bdfb95d13fcbc9737424ee8a33b7c979c51e6b4