quicklastfmnowplaying
v1.1.0
Published
A dumb/quick module to get current playing track
Downloads
3
Readme
LastFMNowPlaying
A dumb/quick module to get current playing track
Notes:
Dumb loop fetch of user.getRecentTracks you will need a API key from Last.fm
Uses node-fetch to make the request.
Example usage:
var lfmnp = require('QuickLastFMNowPlaying');
var c = new lfmnp.QuickLastFMNowPlaying({
api_key: some_apikey,
user: some_lastFM_username
});
c.on('error', function(e) {
console.error(e);
}).on('warning', function(e) {
console.error('Got a', e.code, e.body);
}).on('song', function(s) {
console.log('song', s.name, 'by', s.artist['#text']);
}).on('always', function(s) {
console.log('always', s);
})
Options
api_key
- string, required, you need a API Key in order to poll Last.fmuser
- string, required, the username to fetch songs for,poll_time
- int, optional, default10000
- time between polls in MSnowplaying_only
- boolean, optional, defaultfalse
, iftrue
only return asong
event if the current song is actually playinguser_agent
- override the default useragent, helps ID your calls to LastFM in the event of a problem
Events
error
- percolates an error if request gets one, or an error with the response, passed the erroralways
- emits the whole response ofuser.getrecenttracks
song
- the song changed, returns the first track objectnochange
- the poll completed, but the song didn't change, nothing is passedwarning
- non 200 call from the API, either Last.fm tripped, or you are polling to quick and hit a rate limit. passes an object containting the HTTP Code ascode
and thebody
response
Change Log
v1.1.0
Swapped from Got to Node Fetch And a Rename to QuickLastFMNowPlaying