nigel-daniels / MMM-Weather-Now

MagicMirror 2 module to show the current weather using the Open Weather API.
MIT License
7 stars 10 forks source link

MMM-Weather-Now

Weather now OR Weather now

This a module for the MagicMirror. This module shows weather conditions now using the Weather.API. This is designed to compliment the MMM-3Day-Forecast module.

Note: This module used to use OpenWeather but they are changing their API and reducing the free calls :-( As of May 2024 the module has migrated to using the weather.API API. The only thing you should need to change in the config is your api_key (See below).

Installation

  1. Navigate into your MagicMirror's modules folder and execute git clone https://github.com/nigel-daniels/MMM-Weather-Now. A new folder MMM-Weather-Now will appear, navigate into it.
  2. Execute npm install to install the node dependencies.

Config

The entry in config.js can include the following options:

Option Description
api_key Required This is the API key you need to use to request weather data from the Open Weather site. Details on how to request an API key can be found here

Type: string
Default value: null
lat This is the latitude of the location you want to get the weather for.

Type: number
Default value: 0.0
lon This is the longitude of the location you want to get the weather for.

Type: number
Default value: 0.0
units This is the units you want the weather reporting in.

Type string Use M for metric OR I for imperial.
Default value: M
lang This is the two character country code for the language you want the weather in, see all the supported codes here.*

Type string
Default value en
tableView This switches the look to use a more compact table based view.

Type boolean
Default value false
interval How often the weather is updated.

Type: integer
Default value: 900000 // 15 minutes

* This module itself only currently supports da, en, es, it , de and nb for the text 'Now' and 'Feels like', thanks for the contributions! If you have translations for these please send them over and I'll add your language to the set I can support :)

Here is an example of an entry in config.js

{
    module:     'MMM-Weather-Now',
    position:   'top_right',
    config: {
        api_key:    'xxxxxxxxxxxxxxxxxxxxxx',
        lat:        37.3397352,
        lon:        -121.894958,
        units:      'M',
        lang:       'en',
        interval:   900000
    }
},

Dependencies

Notes

I hope you like this module, I know it duplicates many other weather modules, however I missed my home-brew mirrors weather information so I recreated it for MM2. Feel free to submit pull requests or post issues and I'll do my best to respond.

Thanks To...