Skip to content

clock

Displays the current time.

SettingTypeDefaultDescription
formatstring{:%H:%M}Clock format string for horizontal bars and vertical fallback. Use \n for multiple lines; examples: {:%H:%M}\n{:%d/%m}, %H:%M, {:%-I:%M %p}. See Date format tokens.
vertical_formatstring""Format used when the bar is vertical. When empty, falls back to format with : replaced by line breaks. Supports the same syntax as format.
tooltip_formatstring""Optional format shown when mouse is hovered over the clock widget. This utilizes the same date format tokens as format.
timezonestring""Optional timezone identifier (e.g. Europe/Berlin, UTC) to use for this clock. If empty, uses the system’s local time.
[widget.clock]
format = "{:%H:%M}\n{:%d/%m}"
vertical_format = "{:%H\n%M}"
tooltip_format = "{:%A, %B %d, %Y}"
[widget.clock-12h]
type = "clock"
format = "{:%-I:%M %p}"
[widget.clock-seconds]
type = "clock"
format = "{:%H:%M:%S}"
vertical_format = "{:%H\n%M\n%S}"