Weather forecast

Note

In version 3.8.2 Dashticz switched to the new weather block as described here.

Dashticz supports the following weather forecast providers:

Before you can use the weather module, you must request an API key:

Note

Since November 2022 OpenWeatherMap doesn’t provide anymore new api keys with full functionality

Basic usage

A basic weather block can be defined as follows:

blocks['weather'] = {
  type: 'weather',
  apikey: 'abc123...xyz', /Your API key
  city: 'Amsterdam',
}
../../_images/weather_default.jpg

Besides the daily forecast, you can also show the current weather or an hourly forecast.

Parameters

Block parameter Description
type 'weather'. To select a weather block
width 1..12: Width of the block
refresh 3600 Update once per hour. (default=3600, minimum=900, 15 minutes)
scale
Number between 0 and 1 to make the weather block smaller
1 Normal block width
0.5 50% width
apikey 'abc123...xyz'. OWM api key
city 'Amsterdam'. City name. You can also use the OWM city id code.
country 'nl'. Country code.
name 'My place'. Name to use instead of city name on the dashboard.
lang 'nl': Language to use for OWM data
provider
owm: Use OpenWeatherMap as provider
knmi: Use KNMI as provider
layout
Choose a layout for the weather block
0: Daily forecast (=default)
1: Hourly forecast (for OWM only)
2: Current weather
3: Current weather detailed
4: Combination of 2,3,0,1
count 5: Number of forecast items to show (default=3). Only for daily and hourly forecast.
interval
Use every n-th forecast item.
1. Use every forecast item (=default)
3. Set to 3 to get 3-hourly forecast
decimals
Number of temperature decimals to show
1 One decimal (=default)
showMin
Show/hide minimum temperature (only for daily forecast)
false: Hide minimum temperature
true: Show minimum temperature (=default)
showRain
Show/hide rain rate (only for daily and hourly forecast)
false: Hide rain rate
true: Show rain rate (=default)
showDescription
Show/hide weather description (only for daily and hourly forecast)
false: Hide weather description
true: Show weather description
showWind
Show/hide wind info and wind dial (daily and hourly forecast only)
false: Hide wind info
true: Show wind info (=default)
useBeaufort Set to true to show wind speed in Beaufort instead of m/s
skipFirst Set to true to skip the first daily/hourly forecast card
monochrome
false: Show colored icons (animated weather icons only)
true: Show monochrome icons (animated weather icons only)
showCurrent Set to false to hide current weather (layout 4 only)
showDetails Set to false to hide current weather details (layout 4 only)
showDaily Set to false to hide daily weather forecast (layout 4 only)
showHourly Set to false to hide hourly weather forecast (layout 4 only)
icons
Icon set to use. See below
'line' Dynamic line icons
'linestatic' Static version of the line icons
'fill' Dynamic filled icons
'static' Static icons
'meteo' Alternative set of static icons

The weather module makes use of the following CONFIG parameters:

Parameter Description
owm_api '<api-key>' API-key provided by https://openweathermap.org/
owm_city
Your city or nearby city to use in OWM. You can also fill in the city id here.
'Utrecht'
'2748075'
owm_name
Name to use instead of city name
'Tuinwijk'
owm_country
Your country to use in OWM
'nl'
owm_lang
Set language for de description of the forecast (rain, cloudy, etc.). For available languages, see https://openweathermap.org/forecast5/#multi
'' (empty string, default) Use Dashticz language setting
owm_cnt
Number of forecast elements (3-hour intervals or days) to show
1..5
owm_min
Show minimum temperature on 2nd row (only for daily forecast)
false / true
static_weathericons
true Static weather settings
false (default) Animated weather icons
use_beaufort
This config setting is used as default value for block parameter useBeaufort
true Use Beaufort for wind speed
false Use m/s for wind speed

Usage

In the next examples the config parameter owm_api and owm_city have been set globally, so they are not part of the weather block definitions.

To show the hourly forecast with an 3 hour interval:

blocks['weather1'] = {
    type: 'weather',
    layout: 1,
    count: 7,
    interval: 3,
}
../../_images/weather_hourly.jpg

To show the current weather, with a custom name:

blocks['weather2'] = {
  type: 'weather',
  layout: 2,
  name: 'My place',
}
../../_images/weather_current.jpg

To show detailed info on the current weather:

blocks['weather3'] = {
    type: 'weather',
    layout: 3,
    name:'Home is home',
}
../../_images/weather_detailed.jpg

Icons

Via the block parameter icons you can choose one of the predefined icon sets:

  • ‘line’ (=default)
  • ‘linestatic’
  • ‘fill’
  • ‘static’
  • ‘meteo’

By setting the block parameter monochrome to true the icons will be displayed as monochrome.

This will give the following icons sets to choose from:

../../_images/weather_icons.jpg

styling

All blocks have the css class weather assigned in combination with weather_0, weather_1, …, where the number indicates the layout number.

Further, all info items have css classes assigned. The names are self explanatory.

  • icon: Weather icon
  • day: Day item (‘Saturday’)
  • time: Forecast time (hourly forecast only)
  • city: City name
  • description: Weather description
  • temp: temperature
  • max: Max temperature
  • min: Min temperature
  • temp: Current temperature
  • feels: Feel-like temperature
  • rain: Rain rate
  • humidity
  • pressure: Barometric pressure
  • windspeed
  • windgust
  • winddirection

To capitalize the day of the week have to add the following code to custom.css:

.weather .day {
  text-transform: capitalize;
}