Module: User

Note

This page is auto-generated from man/waybar-user.5.scd on the master branch. Do not edit it here — changes will be overwritten on the next sync. To update it, edit the man page(s) and open a PR.

DESCRIPTION

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

CONFIGURATION

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

FORMAT REPLACEMENTS

• {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

EXAMPLES

"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
}

STYLE

• #user