Skip to content
Java data bindings for the Cover Art Archive (
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.


Java data bindings for the Cover Art Archive.

Things to know

  • Provides access to cover art through the /release/{mbid}/ or /release-group/{mbid}/ end points.
  • The Javadoc can be generated by running mvn javadoc:javadoc.


The recommended way of using coverartarchive-api is through Maven. Add the coverartarchive-api dependency to your project's POM:


(Alternatively, a JAR file can be obtained from Maven Central: fm.last:coverartarchive-api:2.1.1)

Usage example

Get all cover art for Portishead's 'Dummy' release:

CoverArtArchiveClient client = new DefaultCoverArtArchiveClient();
UUID mbid = UUID.fromString("76df3287-6cda-33eb-8e9a-044b5e15ffdd");

CoverArt coverArt = null;
try {
  coverArt = client.getByMbid(mbid);
  if (coverArt != null) {
    for (CoverArtImage coverArtImage : coverArt.getImages()) {
      File output = new File(mbid.toString() + "_" + coverArtImage.getId() + ".jpg");
      FileUtils.copyInputStreamToFile(coverArtImage.getImage(), output);
} catch (Exception e) {
  // ...

To get all cover art for Portishead's 'Dummy' using the release-group endpoint, replace:

coverArt = client.getByMbid(mbid);


coverArt = client.getReleaseGroupByMbid(mbid);

To query using HTTPs instead of plain HTTP, create the client as follows.

final boolean useHttps = true;
CoverArtArchiveClient client = new DefaultCoverArtArchiveClient(useHttps);

Note that URLs for images returned by the service may still contain insecure addresses. To detect these cases you can query the URLs for each returned image by calling CoverArtImage.getImageUrl().

Running the tests

  • Run mvn clean verify


All contributions are welcome. Please use the codeformatting profile found in the lastfm-oss-config project for formatting your changes.


Copyright 2012-2018

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Kthxbye <3 MusicBrainz

You can’t perform that action at this time.