waybar-user(5) User Manual waybar-user(5)

waybar - user module

The user module displays the currently logged in user, the system uptime and, optionally, the user's avatar image.

Addressed by user

Option Typeof Default Description
interval integer 60 The interval in which the information gets polled
format string {user} {work_H}:{work_M} The format, how the information should be displayed. See FORMAT REPLACEMENTS below
icon bool false When enabled, displays the user's avatar image next to the label
avatar string $HOME/.face Path to the avatar image to display. Only used when icon is enabled. When unset, the default path $HOME/.face is used
height integer 20 The height of the avatar image in pixels
width integer 20 The width of the avatar image in pixels
open-on-click bool false When enabled, left-clicking the module opens the user's home directory (or open-path) with the default file manager
open-path string Overrides the path that is opened when open-on-click is enabled. When empty, the user's home directory is used
rotate integer Positive value to rotate the text label (in 90 degree increments)
tooltip bool true Option to enable tooltip on hover

  • {user}: The login name of the currently logged in user, in uppercase
  • {work_d}: Whole days the system has been up
  • {work_H}: Hours part of the system uptime (00-23)
  • {work_M}: Minutes part of the system uptime (00-59)
  • {work_S}: Seconds part of the system uptime (00-59)
  • {up_H}: Hour the system was booted (00-23)
  • {up_M}: Minute the system was booted (00-59)
  • {up_d}: Day of the month the system was booted (01-31)
  • {up_m}: Month the system was booted (01-12)
  • {up_Y}: Year the system was booted

"user": {
	"format": "{user} up {work_H}:{work_M}:{work_S}",
	"interval": 60,
	"icon": true,
	"avatar": "/home/alice/.face",
	"height": 24,
	"width": 24,
	"open-on-click": true
}

•
#user

Alexis Rouillard <contact@arouillard.fr>

2026-11-05 waybar-user