coverart
v0.0.1
Published
Fetch music cover art form the Cover Art Archive
Downloads
18
Readme
Cover Art for Node
Cover Art allows you to fetch album artwork from the Cover Art Archive using their API.
Example Usage
It's always a good idea to give your client a unique User Agent.
var CA = require('coverart');
// Initialize Cover Art
var ca = new CA({userAgent:'my-awesome-app/0.0.1 ( http://my-awesome-app.com )'});
Resources
There are two main resources: release
and release group
.
Release
Fetches a JSON listing of available cover art for a MusicBrainz release.
ca.release('660c1995-c6a0-4c90-b158-2f2d9caff78f', function(err, response){
console.log(response);
});
Fetching a specific piece of album art
With the option piece
set to front
, fetch the image that is most suitable to be called the "front" of a release. piece
also accepts back
and an image id
ca.release('660c1995-c6a0-4c90-b158-2f2d9caff78f', {piece: 'front'}, function(err, response){
console.log(response);
// {
// "contentType": "image/jpeg",
// "extension": ".jpeg",
// "image": ... binary image ...
// }
});
Specifiying a size
Album art thumbnails comes in two sizes: small
(up to 250 px) and large
(up to 500 px). In the options you can either specifiy the size by the string or by pixels
ca.release('660c1995-c6a0-4c90-b158-2f2d9caff78f', {piece: 'back', size: 'small'}, function(err, response){
console.log(response);
});
Release Group
Fetches a JSON listing of available cover art for a MusicBrainz release group
, as well as the url for the specific release from which the art was sourced.
ca.releaseGroup('02f79295-21e1-34cc-82f2-63219eec4f0a' ,function(err, response){
console.log(response);
// {
// "images": [
// {
// "types": [
// "Front"
// ],
// "front": true,
// "back": false,
// "edit": 22995833,
// "image": "http://coverartarchive.org/release/472168df-be3a-44ee-b31d-393155f3366d/4686417696.jpg",
// "comment": "",
// "approved": true,
// "thumbnails": {
// "large": "http://coverartarchive.org/release/472168df-be3a-44ee-b31d-393155f3366d/4686417696-500.jpg",
// "small": "http://coverartarchive.org/release/472168df-be3a-44ee-b31d-393155f3366d/4686417696-250.jpg"
// },
// "id": "4686417696"
// }
// ],
// "release": "http://musicbrainz.org/release/472168df-be3a-44ee-b31d-393155f3366d"
// }
});