MMM-Scrobbler

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

★ 40 Open GitHub ↗

This is an extension for the MagicMirror. It displays your currently playing music.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# MMM-Scrobbler
This is an extension for the [MagicMirror](https://github.com/MichMich/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](https://secure.last.fm/de/join)

2. Create an [api key](http://www.last.fm/api/account/create) (-- 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](http://www.cnet.com/how-to/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,
		}
	
}

MMM-Scrobbler

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README