MMM-Profilepicture

A simple module to add a background picture to the selected profile.

This module works well with the MMM-ProfileSwitcher module. Set the URL to the user's picture, then set the class for each user on each instance of the module in your config.

Note: I'm new to the MagicMirror² world and Node.js, this is my first real module. There are probably lots of things that could have been done better. :)

Screenshots

Janes Profilepicture:

Johns Profilepicture:

Usage

Prerequisites

• Requires MagicMirror² v2.1.0
• Install and run MagicMirror²

Installation

In your terminal, go to your MagicMirror² modules folder:

cd ~/MagicMirror/modules

Clone this repository:

git clone https://github.com/Snille/MMM-Profilepicture.git
cd MMM-Profilepicture

Update

To update the module:

cd ~/MagicMirror/modules/MMM-Profilepicture
git pull
npm install

Add some config entries with at least the required options in your config.js file. Add the module one time for each user, with different URLs for each user.

Configuration

	// Johns picture.
	{
		module: "MMM-Profilepicture",
		position: "fullscreen_below",
		// This will show the picture only for the "John" user.
		classes: "John"
		config: {
			// See below for configurable options
			url: "http://the-url-to-johns-picture",
		}
	},
	// Janes picture.
	{
		module: "MMM-Profilepicture",
		position: "fullscreen_below",
		// This will show the picture only for the "Jane" user.
		classes: "Jane"
		config: {
			// See below for configurable options
			url: "http://the-url-to-janes-picture",
		}
	},
	// And so on...

Options

Here are the configuration options to configure the module.

Option	Description
opacity	Transparency of the picture. 1.0 is not transparent at all. Default value: 0.2
maxWidth	Maximum width of the picture. Default value: 100%
maxHeight	Maximum height of the picture. Default value: 100%
updateInterval	Picture refresh time in milliseconds (1000 * 60 * 5) = 5 min. false = no auto update Default value: false
fadeSpeed	Fade speed in milliseconds when updating the picture. Default value: 800
id	The id of this module. If you want to refresh only this module's picture remotely you need to set an ID (int) and then send REFRESHPICTUREID, where ID is the number here. Default value: false
url	The URL to the picture. Required value: URL

All done. :)