Cover Art Archive: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
(add link to cover art archive website)
 
(8 intermediate revisions by 6 users not shown)
Line 1: Line 1:
The [https://coverartarchive.org/ 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)]].
== Introduction ==


==Contribute==
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.
To know more about submitting cover art to the Cover Art Archive, see [[How to Add Cover Art]]


==API==
== Fetching Cover Art ==
To know more about the API to fetch cover art from the Cover Art Archive, see our [[Cover Art Archive/API|API page]]


==Policy==
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:
These covers are being collected for archival purposes, and the collection will be accessible to the public. Use the images at your own risk. The Internet Archive's policy can be read [http://archive.org/about/terms.php here].


We ask that you:
<nowiki>http://coverartarchive.org/release/(MBID)/front-1.jpg</nowiki>


* Be respectul of the rights of the artists and labels.
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:
* Go make the music industry a better place.
* Go make the world a better place.
* Go make cool stuff.


[[Category:Terminology]] [[Category:WikiDocs Page]] [[Category:Cover Art]]
http://coverartarchive.org/release/8f468f36-8c7e-4fc1-9166-50664d267127/front-1.jpg

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.

== Supported Image Types ==

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:

<nowiki>http://coverartarchive.org/release/(MBID)/(type)-(page)[-(size)].jpg</nowiki>

In addition to the MBID already mentioned, (type) is also supported. Type can be one of:

front, back, inner, booklet, sleeve, medium, obi, spine, box, other

(TODO: define each of these)

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/booklet-1.jpg
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.

==Submitting Cover Art==

Recommended settings:
* JPG compression
* 300 dpi

File size limit: 15MB.

[[Category:Terminology]]

Latest revision as of 05:42, 27 April 2020

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).

Contribute

To know more about submitting cover art to the Cover Art Archive, see How to Add Cover Art

API

To know more about the API to fetch cover art from the Cover Art Archive, see our API page

Policy

These covers are being collected for archival purposes, and the collection will be accessible to the public. Use the images at your own risk. The Internet Archive's policy can be read here.

We ask that you:

  • Be respectul of the rights of the artists and labels.
  • Go make the music industry a better place.
  • Go make the world a better place.
  • Go make cool stuff.