coverart
v0.0.1
Published
Fetch music cover art form the Cover Art Archive
Downloads
8
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"
// }
});