README.md

MMM-Scrobbler

This is an extension for the MagicMirror. It displays your currently playing music. To use this module you need to have a Last.fm account and scrobble your music.

Installation

1. Navigate into your MagicMirror's modules folder and execute git clone https://github.com/PtrBld/MMM-Scrobbler.git.

2. A new folder will appear. That's all :)

Configuration

You can scrobble all your music with Last.fm.

1. Create an account

2. Create an api key (-- INFO: The api key has to be exclusive. If you already have a api key from another project, just create a new one for this project.)

3. Configure your client to scrobble your music. How To: Scrobble to Last.fm from iTunes, Spotify, and more

Module Usage

The entry in the module array in your config.js can look like the following. Only username and apikey are mandatory fields. All other fields have default values.

{
			
	module: 'MMM-Scrobbler',
	
	position: 'top_right',
	config: {

		username: 'Last.fm username',
	
		apikey: 'Last.fm api key',
	
		//time interval to search for new song (every 15 seconds)
		updateInterval: 15 * 1000,
		//how often should we try to retrieve a song if not listening
		delayCount: 5,
		//time interval to search for new song if the 5 times not listening is received.
		//set this to the same number as updateInterval to ignore this option	
		delayInterval: 120*1000,
		animationSpeed: 1000,
		showAlbumArt: true,
	    	showMetaData: true,
		//Determines the position of the meta text. Possible values: top, bottom, left, right
		alignment: "bottom", 
		//The scrobbler api is quite buggy, this will retry the exact same thing if it fails due to an api error
		//retryOnFailure: true,
		}
	
}