README.md

MMM-ISS-information

Magic Mirror Module to display ISS information based on the Open Notify API

Using the module

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

	{
		module: 'MMM-ISS-information',
		position: 'bottom_right',	// This can be any of the regions
		header: 'ISS information'
		 config: {
            // See 'Configuration options' for more information.
            iss_map: true, 		//shows a map with realtime ISS location
            iss_people: true, 	//shows how many people are in space
            iss_pass: true, 	//true: shows a list of the next time ISS passes above given coordinates
            // the following variables are required if iss_pass is true:
           	//latitude: 52.37, 	//latitude of your location
            //longitude: 4.89,	//longitude of your location
        }
	}

Installation

1. Navigate into your MagicMirror's modules folder and execute git clone https://github.com/washichi/MMM-ISS-information.git. A new folder will appear.

Configuration options

based on the OpenNotify documentation: [http://open-notify.org/Open-Notify-API]

Option	Description
iss_map	REQUIRED Shows an map with the realtime ISS position. Default value: true
iss_people	REQUIRED Shows the number of people in space. Default value: true
iss_pass	REQUIRED Lists upcoming ISS passes above given coördinates. Default value: true
latitude	OPTIONAL Latitude, used to display iss_pass. Default value: Amsterdam latitude
longitude	OPTIONAL Latitude, used to display iss_pass. Default value: Amsterdam longitude
amount	OPTIONAL amount of ISS passes that are listed. Default value: 5
map_style	OPTIONAL map style. You can download/create your own style at mapbox Default map style: preview
map_height	OPTIONAL Height of the map. Default value: 150px
map_width	OPTIONAL Width of the map. Default value: 250px
map_zoom	OPTIONAL Zoom level of the map. Default value: 1

Many other configuration options for the map are listed in the official Leaflet documentation.