Clocks

Displays a configurable list of world clocks, the local time, and date.

Configuration


clocks:
  colors:
    rows:
      even: "lightblue"
      odd: "white"
  enabled: true
  locations:
    # From https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
    - Avignon: "Europe/Paris"
    - Barcelona: "Europe/Madrid"
    - Dubai: "Asia/Dubai"
    - New York: "America/New York"
    - Toronto: "America/Toronto"
    - UTC: "Etc/UTC"
    - Vancouver: "America/Vancouver"
  position:
    top: 4
    left: 0
    height: 1
    width: 1
  refreshInterval: 15
  # Valid options are: alphabetical, chronological, natural
  sort: "alphabetical"

Screenshots

clocks screenshot

Attributes

Name Description Value
border Optional Whether or not to draw this widget with a border. Default: true. true, false
colors.rows.even The foreground color for even-numbered rows. Any X11 color name.
colors.rows.odd The foreground color for odd-numbered rows. Any X11 color name.
dateFormat The format to use when rendering date strings. Any valid Go date layout which is handled by Time.Format. Defaults to Jan 2.
enabled Optional Whether or not this module is executed and if its data displayed onscreen. Default: false. true, false
`locations`A list of timezone for the clocks to be displayed.Any TZ database timezone.
position Defines where in the grid this module's widget will be displayed.
refreshInterval Optional How often, in seconds, this module will update its data. Default: 300. Any positive integer
sort The order in which to sort the clocks. alphabetical, chronological, or natural. alphabetical will sort in acending order by key, chronological will sort in ascending order by date/time, natural will maintain the config file ordering.
timeFormat The format to use when rendering time strings. Any valid Go time layout which is handled by Time.Format. Default: 15:04 MST.

Source Code

https://github.com/wtfutil/wtf/tree/master/modules/clocks/