mmm-imagesphotos's Introduction

MMM-ImagesPhotos

This is a module for the MagicMirror. It will show photos from a directory.

This module reads the images from the uploads directory inside the module. Directory: MagicMirror/modules/MMM-ImagesPhotos/uploads

Installation

Clone this repository inside your MagicMirror's modules folder

cd ~/MagicMirror/modules

git clone https://github.com/roramirez/MMM-ImagesPhotos.git.

How it looks

Config

The entry in config.js can include the following options:

Option	Description
`opacity`	The opacity of the image. Type: `double` Default 0.9
`animationSpeed`	How long the fade out and fade in of photos should take. Type: `int` Default 500
`updateInterval`	How long before loading a new image. Type: `int`(milliseconds) Default 5000 milliseconds
`getInterval`	Interval value to get new images from directory. Type: `int`(milliseconds) Default 60000 milliseconds
`maxWidth`	Value for maximum width. Optional, possible values: absolute (e.g. "700px") or relative ("50%") Default 100%
`maxHeight`	Value for maximum height. Optional, possible values: absolute (e.g. "400px") or relative ("70%") Default 100%
`backgroundColor`	Value for color used to fill around the image if not fullscreen, default 'black', can be #xxyyzz, like #808080 (grey), if fill is true, the backgroundColor setting is ignored
`fill`	true or false, default false. instead of color use a blurred copy of the image to fill around the image
`blur`	the size of the pixel blur of the background fill, default 8

Here is an example of an entry in config.js

{
	module: "MMM-ImagesPhotos",
	position: "middle_center",
	config: {
		opacity: 0.9,
		animationSpeed: 500,
		updateInterval: 5000,
		backgroundColor: 'grey',  // not used if fill is true
		fill: false,   // fill around image with blurred copy of image
		blur: 10,   // only used if fill is true
	}
},

Recommend Projects