Modules: Weather

May 09, 2018

Displays a configurable list of current weather report, including current temperature, sunrise time, and sunset time.

weather screenshot

Source Code

wtf/weather/

Required ENV Variables

Key: WTF_OWM_API_KEY
Action: Your OpenWeatherMap API key.

Keyboard Commands

Key: /
Action: Open/close the widget’s help window.

Key: h
Action: Show the previous weather location.

Key: l
Action: Show the next weather location.

Key: ←
Action: Show the previous weather location.

Key: →
Action: Show the next weather location.

Configuration

weather:
  # From http://openweathermap.org/help/city_list.txt
  cityids:
  - 6173331
  - 3128760
  - 6167865
  - 6176823
  colors:
    current: "lightblue"
  enabled: true
  language: "EN"
  position:
    top: 0
    left: 2
    height: 1
    width: 1
  refreshInterval: 900
  tempUnit: "C"

Attributes

cityids
A list of the OpenWeatherMap city IDs for the cities you want to view.
Values: A list of positive integers, 0..n

colors.current
The color to highlight the current temperature in.
Values: Any X11 color name.

enabled
Determines whether or not this module is executed and if its data displayed onscreen.
Values: true, false.

language
The human language in which to present the weather data.
Values: Any language identifier specified by OpenWeatherMap.

position
Defines where in the grid this module’s widget will be displayed.

refreshInterval
How often, in seconds, this module will update its data.
Values: A positive integer, 0..n.

tempUnit
The temperature scale in which to display temperature values.
Values: F for Fahrenheit, C for Celcius.

Content