Skip to content

Magic Mirror² module to display ISS fly-overs in your area

License

Notifications You must be signed in to change notification settings

daterrell/MMM-ISS

Repository files navigation

Magic Mirror Module: ISS Fly-Overs

This modules for the Magic Mirror² will show a card when there's an ISS flyover with a good possibility of viewing.

The Module

This is v1.0 -- and, as the module does what I want, won't likely change much.

Why?

Why another ISS module when mykle1 has already created one that works fine? Well, personal preference. I didn't like the NASA widget look compared to the aesthetics of the rest of my mirror. Plus, the APIs mykle1 is using (or rather, the APIs that the APIs are using) are slated to be shut down (see the first output line of the old spaceflight page).

So, here we are.

NB: The minElevation property will filter out any sighting whose Max Elevation is below your minElevation value; the default is 40 degrees. When there are no sightings, the panel is hidden. I find this useful because MM is generally quite static. Having the panel shown only when there are viewable sightings draws attention when it is present.

How?

Manual install

  1. Clone this repository in your modules folder, and install dependencies:
cd ~/MagicMirror/modules # adapt directory if you are using a different one
git clone https://github.com/daterrell/MMM-ISS.git
cd MMM-ISS
npm install
  1. Add the module to your config/config.js file.
{
  module: 'MMM-ISS',
  position: 'bottom_center',
  config: {
    // These values must come from available locations on the SpotTheStation site: https://spotthestation.nasa.gov/
    country: "United States",
    region: "Massachusetts",
    city: "Boston",
    minElevation: 40 // Lowest elevation for the panel to show up
  }
},

About

Magic Mirror² module to display ISS fly-overs in your area

Resources

License

Stars

Watchers

Forks