Skip to content
Magic Mirror Module that displays the current moon phase
JavaScript CSS Roff
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
images Small tweaks to code Jun 22, 2019
.eslintrc.json First commit May 13, 2019
.stylelintrc First commit May 13, 2019 First commit May 13, 2019
MMM-MoonPhase.js README fixes Jun 22, 2019 typos fixed Jun 22, 2019
node_helper.js First commit May 13, 2019
package.json First commit May 13, 2019


This is a module for the MagicMirror².

Displays the realtime moonphase and increments the shadow daily.

Demo Image

Using the module

To install this module, navigate into ~/MagicMirror/modules and type the following commands:

git clone
cd MMM-MagicMirror
npm install

To use this module, add the following configuration block to the modules array in the config/config.js file:

var config = {
    modules: [
			module: "MMM-MoonPhase",
			position: "top_center",
			config: {
				updateInterval: 43200000,
				hemisphere: "N",
				resolution: "detailed",
				basicColor: "white",
				title: true,
				phase: true,
				x: 200,
				y: 200,
				alpha: 0.7

Configuration options

Option Description Default Possible
updateInterval Optional Miliseconds between updates 43200000 (12 hours) any
hemisphere Optional Your location on the earth "N" (North) "N"/"S"
resolution Optional Use detailed moon image or basic circle "detailed" "detailed"/"basic"
basicColor Optional Color of moon if using basic resolution "white" any valid css color
title Optional Toggle module title true true/false
phase Optional Toggle phase label true true/false
x Optional Width (recommended <300) 200 >0
y Optional Height (recommended <300) 200 >0
alpha Optional Visibility of dark side of moon 1 (Invisible) >=0 to <= 1
You can’t perform that action at this time.