# Weather Module

This module will be configurable to be used as a current weather view, or to show the forecast. This way the module can be used twice to fulfill both purposes.

The biggest change is the use of weather providers. This way we are not bound to one API source. And users can choose which API they want to use as their source.

The module is in a very early stage, and needs a lot of work. It's API isn't set in stone, so keep that in mind when you want to contribute.

# Example

# Usage

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

modules: [
  {
    module: "weather",
    position: "top_right",
    config: {
      // See 'Configuration options' for more information.
      type: "current",
    },
  },
];

# Configuration options

The following properties can be configured:

# General options

# Current weather options

# Weather forecast options

# Openweathermap options

# Darksky options

# Weather.gov options

# UK Met Office (ukmetoffice) options

# UK Met Office (ukmetofficedatahub) options

# Weatherbit options

# SMHI options

# Environment Canada (envcanada) options

Note that envcanada supports Canadian locations only.

When using the type: "forecast" config, the module can display a max of 6 days (Today + the next 5 days). The forecast for each day reflects the daytime forecast. The Today forecast is a special case that will reflect the daytime forecast until late afternoon, after which Today will be reflecting the nightime forecast for the current day.

When using the type: "hourly" config, the module can display a max of 24 hours.

# Weatherflow options

# Yr options

The Yr weather provider is quite simple to set up, and only requires the coordinates for the desired location. These can be obtained from for instance Google Maps by right-clicking the map.

If you use several instances of the Yr weather provider, please set the initialLoadDelay to have a minimum value of 500 between the instances. Yr.no wants as little traffic as possible to their servers, and a slight load delay is enough for the instances to cooperate better when fetching the data.

# Current weather options

Possible options when using the type: "current" config, the module displays the forecast for the specified time. If Yr predicts rain from 1 to 2, and sun from 2 to 3, the rain-symbol will display until 2 and then change on the next update.

# API Provider Development

If you want to add another API provider checkout the Guide.