An animated globe module for Magic Mirror
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 2 commits ahead of Eunanibus:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This an extension for the MagicMirror. It displays a rotating globe constructed of Hexadecimal shapes specifically formatted to look great on a Magic Mirror. Extensive thanks and gratitude to the globe object's original creator Rob Scanlon for all his help and support.


  1. Navigate into your MagicMirror's modules folder and execute git clone A new folder will appear.
  2. Add it to the modules array in the config/config.js (see next step below)

Using the module

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

modules: [
		module: 'MMM-Globe',
		position: 'lower_third',	// This can be any of the regions. Best results in lower_third
		config: {
                size:"medium", // Globe size. See configuration options below for more options
				dayLength: 38, // (Optional) Rotation speed. See configuration options below
			    viewAngle: 15, // (Optional) Globe tilt. See configuration options below.
				introLinesDuration: 2000,
				receiveExternalLocations: 0,
                locations: [
                    // Fill with location Objects if desired
                    // e.g.
                    // {lat:37.77493,lng:-122.41942, label: "San Francisco"},
                    // {lat:-23.5475,lng:-46.63611, label: "Sao Paulo"}

                    // Individual values must be seperated by a comma.
                    // You can look up the latitude and longitude for a specific location on Google Maps.

viewAngle:30, dayLength: 20, introLinesDuration: 2000, receiveExternalLocations: 1,

Configuration options

The following properties can be configured:

Option Required Type Description
size yes string The size you'd like your globe.

i.e : medium
Possible values:x-small small medium large x-large
Default value:medium
dayLength no int The number of seconds for the globe to complete a full rotation.
Possible values: Positive numbers greater than zero.
Default value: 28
viewAngle no int The angle at which to tilt the globe, measure in degrees. Positive values tilt the globe towards the northern hemisphere (Asia, North America, Europe) whilst negative values tilt towards the southern hemisphere (Africa, Australia, South America).
Possible values: Any number between -90 and 90.<br/Default value: 0 (View centered on the equator).
introLinesDuration no int Time the Intro animation runs in milliseconds
Possible values: Any number between 0 and 5000.<br/Default value: 2000 (2 seconds).
receiveExternalLocations no int This module is capable of displaying data provided by other modules like MMM-GoogleAnalytics.
Possible values: 1 (on) and 0 (off)<br/Default value: 0 (off).
locations no string An array of Location objects. These will construct the pins within your globe:. Each value must be seperated within the array by a comma.

{lat: latitudeValue , lng: longitudeValue, label:"Label Value"}

i.e : [{lat:37.77493,lng:-122.41942, label: "San Francisco"}]
Default value: A default array of locations will be provided if none is specified. Leave blank if default locations are OK.


  • All dependencies in this module are self-regulated

The MIT License (MIT)

Copyright © 2016 Eunan Camilleri

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

The software is provided “as is”, without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.