waybar-clock(5) User Manual waybar-clock(5) (NAME) waybar-clock - waybar (DESCRIPTION) clock . (FILES) $XDG_CONFIG_HOME/waybar/config (CONFIGURATION) 1. clock +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ | (Option) | | | (Description) | | | (Typeof) | (Default) | | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |interval | integer | 60 | ( | | | | | ) | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |format | string | {:%H:%M} | | | | | | . | | | | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |timezone | string | | | | | | | | | | | | America/New_York. "" | | | | | | | | | | . | | | | | | | | | | : | | | | | | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |timezones | list of strings | | | | | | | ( timezone) | | | | | | | | | | | | | | | . | | | | | timezones timezone | | | | | . "" | | | | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |timezone-tooltip-format | string | | | | | | | | | | | | (tooltip). | | | | | | | | | | | | | | | ( | | | | | ) | | | | | | | | | | | | | | | | | | | | . | | | | | format | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |locale | string | | (locale) | | | | | . | | | | | | | | | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |max-length | integer | | ( | | | | | ) | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |rotate | integer | | | | | | | ( | | | | | ). | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |on-click | string | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |on-click-middle | string | | | | | | | ( ) | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |on-click-right | string | | | | | | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |on-scroll-up | string | | | | | | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |on-scroll-down | string | | | | | | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |smooth-scrolling-threshold | double | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |tooltip | bool | true | | | | | | | | | | | (tooltip) | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |tooltip-format | string | | | | | | format | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |menu | string | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |menu-file | string | | . | | | | | GtkMenu | | | | | menu | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |menu-actions | array | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ |expand: | bool | false | | | | | | | | | | | | | | | | . | +---------------------------+-----------------+-----------------------+----------------------------------------------------------------+ strftime(3) https://en.cppreference.com/w/cpp/chrono/duration/formatter . 2. clock: calendar +----------------+-----------+-----------------------+---------------------------------------+ | | | | (Description) | |(Option) | (Typeof) | (Default) | | +----------------+-----------+-----------------------+---------------------------------------+ |mode | string | month | | | | | | . | | | | | : year|month | +----------------+-----------+-----------------------+---------------------------------------+ |mode-mon-col | integer | 3 | mode=year. | | | | | | | | | | . | +----------------+-----------+-----------------------+---------------------------------------+ |weeks-pos | string | | | | | | | | | | | | | | | | | | | | | | . | | | | | | | | | | . | | | | | : | | | | | left|right | +----------------+-----------+-----------------------+---------------------------------------+ |on-scroll | integer | 1 | | | | | | / | | | | | /. | | | | | | | | | | . | | | | | on-scroll | | | | | | | | | | . | +----------------+-----------+-----------------------+---------------------------------------+ |iso8601 | bool | false | | | | | | | | | | | | | | | | ISO 8601 | | | | | : | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | . | | | | | | | | | | '{:%V}' . | +----------------+-----------+-----------------------+---------------------------------------+ 3. clock: calendar: format +----------------+-----------+-----------------------+-----------------------------+ | | | | | |(Option) | (Typeof) | (Default) | (Description) | +----------------+-----------+-----------------------+-----------------------------+ |months | string | | | | | | | | | | | | | | | | | | | | | | (January February | | | | | ). | +----------------+-----------+-----------------------+-----------------------------+ |days | string | | | | | | | | | | | | . | +----------------+-----------+-----------------------+-----------------------------+ |weeks | string | {:%U} | | | | | | | | | | | | | | | | | | | | | . | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | : | | | | | | | | | | | | | | | | | | | | | | | | | '{:%W}' | | | | | | | | | | '{:%U}'. | +----------------+-----------+-----------------------+-----------------------------+ |weekdays | string | | | | | | | | | | | | | | | | | | | | | | (Su Mo | | | | | ). | +----------------+-----------+-----------------------+-----------------------------+ |today | string | {} | | | | | | | | | | | | | | | | | | | | | (). | +----------------+-----------+-----------------------+-----------------------------+ (ACTIONS) +----------------------+-----------------------------+ | (String) | (Action) | +----------------------+-----------------------------+ |mode | | | | | | | | | | / | | | (year/month) | +----------------------+-----------------------------+ |tz_up | | | | | | | | | | | | | | +----------------------+-----------------------------+ |tz_down | | | | | | | | | | | | | | +----------------------+-----------------------------+ |shift_up | | | | / | | | | | | | +----------------------+-----------------------------+ |shift_down | | | | / | | | | | | | +----------------------+-----------------------------+ (FORMAT REPLACEMENTS) o {calendar}: o {tz_list}: o {ordinal_date}: () 21st (EXAMPLES) 1. (General) "clock": { "interval": 60, "format": "{:%H:%M}", "max-length": 25 } 2. (Calendar) "clock": { "format": "{:%H:%M} ", "format-alt": "{:%A, %B %d, %Y (%R)} ", "tooltip-format": "{calendar}", "calendar": { "mode" : "year", "mode-mon-col" : 3, "weeks-pos" : "right", "on-scroll" : 1, "on-click-right": "mode", "format": { "months": "{}", "days": "{}", "weeks": "W{}", "weekdays": "{}", "today": "{}" } }, "actions": { "on-click-right": "mode", "on-click-forward": "tz_up", "on-click-backward": "tz_down", "on-scroll-up": "shift_up", "on-scroll-down": "shift_down" } }, 3. (Full date on hover) "clock": { "interval": 60, "tooltip": true, "format": "{:%H.%M}", "tooltip-format": "{:%Y-%m-%d}", } 4. (Show timezone in tooltip only) "clock": { "interval": 60, "format": "{:%H:%M}", "timezone-tooltip-format": "{:%H:%M %Z}", "timezones": [ "", "America/Chicago", "America/Los_Angeles", "Europe/Paris", "UTC" ], "tooltip": true, "tooltip-format": "{tz_list}" } (STYLE) o #clock (TROUBLESHOOTING) clock locale::facet::_S_create_c_locale name not valid : o LC_TIME (glibc) o locale C (musl) locale {calendar} . . (Calendar in Chinese. Alignment) : 1. "WenQuanYi Zen Hei Mono" . 2. size = 9pt . 3. "WenQuanYi Zen Hei Mono" pango (monospace) . "clock": { "format": "{:%H:%M} ", "format-alt": "{:%A, %B %d, %Y (%R)} ", "tooltip-format": "n{calendar}", "calendar": { "mode" : "year", "mode-mon-col" : 3, "weeks-pos" : "right", "on-scroll" : 1, "on-click-right": "mode", "format": { "months": "{}", "days": "{}", "weeks": "W{}", "weekdays": "{}", "today": "{}" } }, "actions": { "on-click-right": "mode", "on-click-forward": "tz_up", "on-click-backward": "tz_down", "on-scroll-up": "shift_up", "on-scroll-down": "shift_down" } }, (AUTHOR) Alexis Rouillard waybar-clock 2026-08-31 waybar-clock(5)