Skip to content
Get album / artist artwork and metadata for use in music apps
JavaScript
Branch: master
Clone or download
stemmlerjs Merge pull request #1 from ssgutierrez42/master
Bug-fix. Changing the source of artist name.
Latest commit 2268705 Feb 24, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Initial commit Nov 19, 2016
README.md Edit README.md Nov 19, 2016
index.js Bug-fix. Changing the source of artist name. Feb 23, 2019
package.json Edit package.json Nov 19, 2016
tests.js Initial commit Nov 19, 2016

README.md

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

You can’t perform that action at this time.