Skip to main content

Open Weather Map

What#

Shows the current weather of a given location.

caution

You must request an API key at the Open Weather Map website. The free tier for Current weather and forecasts collection is sufficient.

Sample Configuration#

{
"type": "owm",
"style": "powerline",
"powerline_symbol": "\uE0B0",
"foreground": "#ffffff",
"background": "#FF0000",
"properties": {
"apikey": "<YOUR_API_KEY>",
"location": "AMSTERDAM,NL",
"units": "metric",
"enable_hyperlink" : false,
"http_timeout": 20,
"cache_timeout": 10
}
}

Properties#

  • apikey: string - Your apikey from Open Weather Map
  • location: string - The requested location. Formatted as <City,STATE,COUNTRY_CODE>. City name, state code and country code divided by comma. Please, refer to ISO 3166 for the state codes or country codes - defaults to DE BILT,NL
  • units: string - Units of measurement. Available values are standard (kelvin), metric (celsius), and imperial (fahrenheit) - defaults to standard
  • enable_hyperlink: bool - Displays an hyperlink to get openweathermap data
  • http_timeout: int - The default timeout for http request is 20ms.
  • cache_timeout: int - The default timeout for request caching is 10m. A value of 0 disables the cache.