waybar(5) File Formats Manual waybar(5) (NAME) waybar - (DESCRIPTION) JSONC config config.jsonc . : o $XDG_CONFIG_HOME/waybar/ o ~/.config/waybar/ o ~/waybar/ o /etc/xdg/waybar/ o /etc/xdg/waybar/ https://github.com/Alexays/Waybar/blob/master/resources/config.jsonc . . waybar CSS waybar-styles(5) . (BAR CONFIGURATION) expand-center typeof: bool default: false modules-center . expand-left typeof: bool default: false modules-left . expand-right typeof: bool default: false modules-left . layer typeof: string default: bottom (top) (bottom) . output typeof: string|array . (!) . sway "HDMI-A-1" "Some Company ABC123 0x00000000" . sway-output(5) . '*' . position typeof: string default: top top bottom left right . height typeof: integer . . width typeof: integer . . modules-left typeof: array . modules-center typeof: array . modules-right typeof: array . margin typeof: string CSS . margin- typeof: integer . no-center typeof: bool default: false expand-* . spacing typeof: integer . name typeof: string CSS waybar. mode typeof: string . mode sway-bar(5) : dock hide invisible overlay. : hide invisible Sway IPC . start_hidden typeof: bool default: false . modifier-reset typeof: string default: press (modifier key) . press . release . . exclusive typeof: bool default: true (exclusive zone) . . fixed-center typeof: bool default: true `modules-center`. . . false . passthrough typeof: bool default: false . top overlay . ipc typeof: bool default: false Sway IPC waybar swaymsg bar. bar_id sway -b id . id typeof: string bar_id Sway IPC. -b bar_id . include typeof: string|array . . : -> -> . . include . reload_style_on_change typeof: bool default: false css css . on-sigusr1 typeof: string default: toggle SIGUSR1 . : show hide toggle reload noop. : toggle. on-sigusr2 typeof: string default: reload SIGUSR2 . : show hide toggle reload noop. : reload. (MODULE FORMAT) PangoMarkupFormat ( https://developer.gnome.org/pango/stable/PangoMarkupFormat.html#PangoMarkupFormat ). : "format": "{}" (MULTIPLE INSTANCES OF A MODULE) '#' . "battery#bat2" . . ( ): "modules-right": ["battery", "battery#bat2"], "battery": { "bat": "BAT1" }, "battery#bat2": { "bat": "BAT2" } (MINIMAL CONFIGURATION) config : { "layer": "top", "modules-left": ["sway/workspaces", "sway/mode"], "modules-center": ["sway/window"], "modules-right": ["battery", "clock"], "sway/window": { "max-length": 50 }, "battery": { "format": "{capacity}% {icon}", "format-icons": ["", "", "", "", ""] }, "clock": { "format-alt": "{:%a, %d. %b %H:%M}" } } (SIGNALS) Waybar : SIGUSR1 ( ) SIGUSR2 ( ) SIGINT `killall -SIGUSR1 waybar` . (User signal configuration) on-sigusr1 on-sigusr2 SIGUSR1 SIGUSR2 . `killall -SIGUSR1 waybar` `killall -SIGUSR2 waybar` . PID `show`/`hide`/`reload` Waybar . PID `pgrep -a waybar` . Kill (Kill parameter meanings) show ( ). hide ( ). toggle ( ). reload waybar waybar ( ). noop kill . (MULTI OUTPUT CONFIGURATION) (Limit a configuration to some outputs) { "layer": "top", "output": "eDP-1", "modules-left": ["sway/workspaces", "sway/mode"], ... } { "layer": "top", "output": ["eDP-1", "VGA"], "modules-left": ["sway/workspaces", "sway/mode"], ... } (Configuration of multiple outputs) . [{ "layer": "top", "output": "eDP-1", "modules-left": ["sway/workspaces", "sway/mode"], ... }, { "layer": "top", "output": "VGA", "modules-right": ["clock"], ... }] (Rotating modules) Waybar . "rotate" . : { "clock": { "rotate": 90 } } "rotate" : 0 90 180 270. (Swapping icon and label) ( ). "swap-icon-label" . : { "sway/window": { "swap-icon-label": true } } (Grouping modules) . . . "orientation" . "group/some-group-name" . . : { "modules-right": ["group/hardware", "clock"], "group/hardware": { "orientation": "vertical", "modules": [ "cpu", "memory", "battery" ] }, ... } () "orientation" : "horizontal" "vertical" "inherit" "orthogonal" (). (Group Drawers) (hover) . `drawer` : transition-duration: typeof: integer default: 500 . children-class: typeof: string default: "hidden" CSS . click-to-reveal: typeof: bool default: false . . transition-left-to-right: typeof: bool default: true . true . false . . "group/power": { "orientation": "inherit", "drawer": { "transition-duration": 500, "children-class": "not-power", "transition-left-to-right": false, }, "modules": [ "custom/power", // <<>> "custom/quit", "custom/lock", "custom/reboot", ] }, (SUPPORTED MODULES) o waybar-backlight(5) o waybar-battery(5) o waybar-bluetooth(5) o waybar-cava(5) o waybar-clock(5) o waybar-cpu(5) o waybar-custom(5) o waybar-disk(5) o waybar-dwl-tags(5) o waybar-dwl-window(5) o waybar-gamemode(5) o waybar-hyprland-language(5) o waybar-hyprland-submap(5) o waybar-hyprland-window(5) o waybar-hyprland-workspaces(5) o waybar-niri-language(5) o waybar-niri-window(5) o waybar-niri-workspaces(5) o waybar-idle-inhibitor(5) o waybar-image(5) o waybar-inhibitor(5) o waybar-jack(5) o waybar-keyboard-state(5) o waybar-memory(5) o waybar-mpd(5) o waybar-mpris(5) o waybar-network(5) o waybar-pulseaudio(5) o waybar-river-layout(5) o waybar-river-mode(5) o waybar-river-tags(5) o waybar-river-window(5) o waybar-sndio(5) o waybar-states(5) o waybar-sway-language(5) o waybar-sway-mode(5) o waybar-sway-scratchpad(5) o waybar-sway-window(5) o waybar-sway-workspaces(5) o waybar-temperature(5) o waybar-tray(5) o waybar-upower(5) o waybar-wireplumber(5) o waybar-wlr-taskbar(5) o waybar-wlr-workspaces(5) (SEE ALSO) sway-output(5) waybar-styles(5) 2026-08-31 waybar(5)