Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including music-md with all npm packages installed. Try it out:

var musicMd = require("music-md")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

music-md v1.0.1

Get metadata for artists and albums for use in music apps.

Music Metadata

Get album / artist artwork and metadata

Install

$ npm install --save music-md

Usage


var musicMeta = require('music-md')

musicMeta.getAlbum('Goo', 'Sonic Youth', 'large')
  .then(function(data) {
    // console.log(data)
    // => 
          { artist: 'Sonic Youth',
            album: 'Goo',
            albumArtwork: 'https://lastfm-img2.akamaized.net/i/u/174s/9fecf539cc254e87b7b44035efd93ea7.png',
            trackList:
             [ { title: 'Dirty Boots', duration: '290', trackNo: 1 },
               { title: 'Tunic (Song for Karen)', duration: '377', trackNo: 2 },
               { title: 'Mary-Christ', duration: '188', trackNo: 3 },
               { title: 'Kool Thing', duration: '244', trackNo: 4 },
               { title: 'Mote', duration: '456', trackNo: 5 },
               { title: 'My Friend Goo', duration: '138', trackNo: 6 },
               { title: 'Disappearer', duration: '295', trackNo: 7 },
               { title: 'Mildred Pierce', duration: '132', trackNo: 8 },
               { title: 'Cinderella\'s Big Score', duration: '354', trackNo: 9 },
               { title: 'Scooter + Jinx', duration: '60', trackNo: 10 },
               { title: 'Titanium Expose', duration: '285', trackNo: 11 } ] 
    }
  })


musicMeta.getArtistInfoAndImage('Nine Inch Nails', 'medium')
  .then(function(data) {
    // console.log(data)
    // => 
      { artwork: 'https://lastfm-img2.akamaized.net/i/u/64s/4395b0232dda4cd08e1a871f5ecf1714.png',
        bio: "Nine Inch Nails is a Cleveland, OH, USA, Industrial rock band that was formed in 1988 by Trent Reznor, the only constant member of the band. He\'s generally credited for popularizing the genre known as "industrial rock" with both his releases and dark, theatrical music videos.\n\nBorn Michael Trent Reznor, he was raised by his maternal grandparents in Mercer, Pennsylvania, USA. Reznor took up piano at the age of five and in high school took up the tuba and saxophone. In the early to mid-80s...",
        tags:  ['industrial',
         'industrial rock',
         'rock',
         'alternative',
         'electronic']
    }
  })

API

getAlbum(album, artist, size)

album

Required
Type: string

Title of the album to search for.

artist

Required Type: string

Album's artist.

size

Required Type: string

possible values: small, medium, large, extralarge, mega

Size of album image to return.

Returns new Promise()

getArtist(artist, size)

artist

Required
Type: string

Title of the artist to search for.

size

Required Type: string

possible values: small, medium, large, extralarge, mega

Size of artist image to return.

Returns new Promise()

License

This package uses the Last.fm API for it's data. You may consult the Last.fm API Terms of Service for license details.

MIT License - Khalil Stemmler

RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free