MMM-OpenWeatherMapForecast

This a module for MagicMirror².

A weather module that displays current, hourly and daily forecast information using data from the OpenWeather One Call API. This is a replacement module for MMM-MyWeather, now that Weather Underground no longer allows free API access. This a complete rewrite from scratch but maintains much of the same functionality.

gerjomarty reworked the module to use OpenWeatherMap after Dark Sky no longer accepts free API access.

NOTE: This module uses the Nunjucks templating system introduced in version 2.2.0 of MagicMirror. If you're seeing nothing on your display where you expect this module to appear, make sure your MagicMirror version is at least 2.2.0.

Installation

1. Execute the following commands to install the module:

cd ~/MagicMirror/modules # navigate to module folder
git clone https://github.com/MarcLandis/MMM-OpenWeatherMapForecast # clone this repository
cd MMM-OpenWeatherMapForecast
npm install # install dependencies

2. Then, add the following into the modules section of your config/config.js file:

{
    module: 'MMM-OpenWeatherMapForecast',
    position: 'top_left',
    config: {
        // See 'Configuration' for more information.
    }
},

Update

Execute the following commands to install the module:

cd ~/MagicMirror/modules/MMM-OpenWeatherMapForecast
git pull
npm install

Configuration

At a minimum you need to supply the following required configuration parameters:

• apikey
• latitude
• longitude

You can request an API key to access data here: https://openweathermap.org/api/one-call-api.

Free tier is fine -- this module will not make any where near 1000 request on one day.

Find out your latitude and longitude here: https://www.latlong.net/.

Other optional parameters

Sample Configuration

    {
      module: "MMM-OpenWeatherMapForecast",
      header: "Weather",
      position: "top_right",
      classes: "default everyone",
      config: {
        apikey: "SUPER SECRET!!!",
        latitude: "51.506130",
        longitude: "-0.090270",      
        iconset: "4c",
        concise: false,
        forecastLayout: "table"
      }
    },

Icon Sets

Layouts

Styling

This module is set to be 300px wide by default. If you wish to override it, you can add the following to your custom.css file:

.MMM-OpenWeatherMapForecast .module-content {
  width: 500px; /* adjust this to taste */
}

Most important elements of this module have one or more class names applied. Examine the MMM-OpenWeatherMapForecast.css or inspect elements directly with your browser of choice to determine what class you would like to override.

For Module Developers

This module broadcasts a notification when it recieves a weather update. The notification is OPENWEATHER_ONE_CALL_FORECAST_DATA and the payload contains OpenWeatherMap's JSON weather forecast object. For details on the weather object, see https://openweathermap.org/api/one-call-api.

Attributions

Skycons - Animated icon set by Dark Sky
http://darkskyapp.github.io/skycons/
(using the fork created by Maxime Warner that allows individual details of the icons to be coloured
https://github.com/maxdow/skycons)

Climacons by Adam Whitcroft
http://adamwhitcroft.com/climacons/

Free Weather Icons by Svilen Petrov
https://www.behance.net/gallery/12410195/Free-Weather-Icons

Weather Icons by Thom
(Designed for DuckDuckGo)
https://dribbble.com/shots/1832162-Weather-Icons

Sets 4 and 5 were found on Graphberry, but I couldn't find the original artists.
https://www.graphberry.com/item/weather-icons
https://www.graphberry.com/item/weathera-weather-forecast-icons

Some of the icons were modified to better work with the module's structure and aesthetic.

Weather data provided by OpenWeather
https://openweathermap.org