Difference between revisions of "Cover Art Archive"

From MusicBrainz Wiki
(Artwork types)
Line 1: Line 1:
 
== Introduction ==
 
== Introduction ==
  
The Cover Art Archive is a cooperation between the [http://archive.org/ Internet Archive] and MusicBrainz that aims to level the playing field for music cover art. Currently, there is no central repository of music cover art (e.g. the images of Audio CD covers) that is freely and easily accessible. The Cover Art Archive aims to fix this situation by creating a collection of cover art that is stored on the Internet Archive's servers and curated by the MusicBrainz community. The images for any release (e.g. an Audio CD) are indexed by [[MBID|MusicBrainz Release ID (MBID)]] and can be fetched by constructing a URL that is based on the MBID.
+
The Cover Art Archive is a cooperation between the [http://archive.org/ Internet Archive] and [[MusicBrainz]] to form a repository of music cover art (e.g. the covers of CDs) that is freely and easily accessible. The Cover Art Archive is stored on the Internet Archive's servers and curated by the MusicBrainz community. The images for any [[Release|release]] are indexed by [[MBID|MusicBrainz Release ID (MBID)]] and can be fetched by constructing a URL that is based on the MBID.
  
 
== Fetching Cover Art ==
 
== Fetching Cover Art ==
  
To construct the URL for the original size front cover for a release with a given MBID, replace (MBID) in the URL below with the MBID of the release:
+
To construct the URL for the original size ''front cover'' for a release with a given MBID, replace (MBID) in the URL below with the MBID of the release:
  
   <nowiki>http://coverartarchive.org/release/(MBID)/front-1.jpg</nowiki>
+
   <nowiki>http://coverartarchive.org/release/(MBID)/front</nowiki>
  
 
For example, to fetch the cover art of [http://musicbrainz.org/release/8f468f36-8c7e-4fc1-9166-50664d267127 Portishead's Dummy CD Audio], which has the MBID of 8f468f36-8c7e-4fc1-9166-50664d267127, you construct the following URL:
 
For example, to fetch the cover art of [http://musicbrainz.org/release/8f468f36-8c7e-4fc1-9166-50664d267127 Portishead's Dummy CD Audio], which has the MBID of 8f468f36-8c7e-4fc1-9166-50664d267127, you construct the following URL:
  
   http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/front-1.jpg
+
   http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/front
  
Then all you need to do is an HTTP GET on that URL to download the cover art. Please note the the coverartarchive.org is only a redirect service when you request one of these URLs will either get a 404 (not found) response or a 307 (moved) redirect response that points to the full Internet Archive URL where the actual image is located. Any modern HTTP client should transparently handle the redirect. If you get a Not Found (404) error, this release does not have cover art in MusicBrainz. Note: The MBID is repeated in the URL because these cover art images are part of the normal Internet Archive collection and their naming convention is friendly to their visitors who might download individual images via their web browser. In order to allow the user to save multiple images to a directory on their own computer without overwriting existing files, each of the files names should be unique.
+
You can do the same for the back cover:  
  
== Supported Image Types ==
+
  http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/back
  
The URL structure allows fetching different types of cover art images and different resolutions of the images. All the details of the URL structure are shown here:
+
Then all you need to do is an HTTP GET on that URL to download the cover art. Please note that coverartarchive.org is only a redirect service: when you request one of these URLs you will either get a 404 (not found) response or a 307 (moved) redirect response that points to the full Internet Archive URL where the actual image is located. Any modern HTTP client should transparently handle the redirect. If you get a Not Found (404) error, this release does not have that piece of cover art in MusicBrainz.
  
  <nowiki>http://coverartarchive.org/release/(MBID)/(type)-(page)[-(size)].jpg</nowiki>
+
''Note'': The MBID appears twice in the full URL because these cover art images are part of the normal Internet Archive collection, and their naming convention is friendly to their visitors, who might download individual images via their web browser. In order to allow the user to save multiple images to a directory on their own computer without overwriting existing files, each of the files names should be unique.
  
In addition to the MBID already mentioned, (type) is also supported. Type can be one of:
+
== Supported Image Types ==
 
 
front, back, inner, booklet, sleeve, medium, obi, spine, box, other
 
  
(TODO: define each of these)
+
While ''/front'' and ''/back'' are the only two automatic redirects, you can get information about what other images the Cover Art Archive has for a specific release by entering the bare URL:  
  
Each of these types define a portion of cover art that could be stored. Not every release will have each of these, but this list conveys all the things that can be stored in the Cover Art Archive. The page argument indicates the one based page for a given type. The front cover of a release can always be found using type ''front'' at page 1: front-1.jpg If the release includes a booklet, you can fetch each of the pages of the booklet by fetching:
+
  http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/
  
  http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/booklet-1.jpg
+
This will give you a JSON file that contains a machine-readable list of all the images, with some details about them and links to both the full size image and two thumbnails (500px and 250px).
  http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/booklet-2.jpg
 
  . . .
 
  
Finally, the optional (size) argument allows some control over which size of image you would like to fetch. If you would like to fetch the original size that was uploaded to the Cover Art Archive, omit the size parameter. If you would like the image where the largest side of the image is 500 or 250 pixels tall or wide, include the -500 (or -250) size argument. Initially the archive will only contain original sized images and 500 pixel thumbnails and 250 pixel thumbnails. If you need an image size that fits between these sizes, download the next larger one and resize it on the client.
+
An image's ''type(s)'' indicate what kind of image it is - you can look at our [[Cover Art Archive/Types|list of types]] to know more. Not every release will have one image of each type, and a lot will have more than one of several of them.
  
 
==Submitting Cover Art==
 
==Submitting Cover Art==
  
Recommended settings:
+
See [[How to Add Cover Art]]
* JPG compression
 
* 300 dpi
 
 
 
File size limit: 15MB.
 
  
 
[[Category:Terminology]]
 
[[Category:Terminology]]

Revision as of 01:32, 17 March 2012

Introduction

The Cover Art Archive is a cooperation between the Internet Archive and MusicBrainz to form a repository of music cover art (e.g. the covers of CDs) that is freely and easily accessible. The Cover Art Archive is stored on the Internet Archive's servers and curated by the MusicBrainz community. The images for any release are indexed by MusicBrainz Release ID (MBID) and can be fetched by constructing a URL that is based on the MBID.

Fetching Cover Art

To construct the URL for the original size front cover for a release with a given MBID, replace (MBID) in the URL below with the MBID of the release:

 http://coverartarchive.org/release/(MBID)/front

For example, to fetch the cover art of Portishead's Dummy CD Audio, which has the MBID of 8f468f36-8c7e-4fc1-9166-50664d267127, you construct the following URL:

 http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/front

You can do the same for the back cover:

 http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/back

Then all you need to do is an HTTP GET on that URL to download the cover art. Please note that coverartarchive.org is only a redirect service: when you request one of these URLs you will either get a 404 (not found) response or a 307 (moved) redirect response that points to the full Internet Archive URL where the actual image is located. Any modern HTTP client should transparently handle the redirect. If you get a Not Found (404) error, this release does not have that piece of cover art in MusicBrainz.

Note: The MBID appears twice in the full URL because these cover art images are part of the normal Internet Archive collection, and their naming convention is friendly to their visitors, who might download individual images via their web browser. In order to allow the user to save multiple images to a directory on their own computer without overwriting existing files, each of the files names should be unique.

Supported Image Types

While /front and /back are the only two automatic redirects, you can get information about what other images the Cover Art Archive has for a specific release by entering the bare URL:

 http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/

This will give you a JSON file that contains a machine-readable list of all the images, with some details about them and links to both the full size image and two thumbnails (500px and 250px).

An image's type(s) indicate what kind of image it is - you can look at our list of types to know more. Not every release will have one image of each type, and a lot will have more than one of several of them.

Submitting Cover Art

See How to Add Cover Art