FreeBSD Manual Pages
WAYLOCK(1) General Commands Manual WAYLOCK(1) NAME waylock - a small Wayland screenlocker SYNOPSIS waylock [options] DESCRIPTION Waylock is a small screenlocker for Wayland compositors implementing ext-session-lock-v1. The ext-session-lock-v1 protocol is significantly more robust than previous client-side Wayland screen locking ap- proaches. Importantly, the screenlocker crashing does not cause the session to be unlocked. OPTIONS -h Print a help message and exit. -version Print the version number and exit. -log-level [error|warning|info|debug] Set the log level of waylock. At the error log level, only errors are logged. At the debug log level, everything is logged including verbose debug messages. -fork-on-lock Fork to the background after locking the session. This is useful to integrate with idle management daemons without racing to lock the session before suspend. With this option waylock will exit once the session has been locked and it is safe to suspend. -ready-fd fd Write a newline to file descriptor fd (a number) after locking and close the fd. This is useful if a fork-less lock notification is needed; for example, for integration with a service manager. -ignore-empty-password Do not submit empty passwords to PAM for validation when the Enter key is pressed. Instead, do nothing. This may be useful if, for ex- ample, the Enter key is used to wake the computer from sleep. -init-color 0xRRGGBB Set the initial color. (default: 0x002b36) -input-color 0xRRGGBB Set the color used after input. (default: 0x6c71c4) -input-alt-color 0xRRGGBB Set the alternate color used after input. (default is what -input- color is set to) -fail-color 0xRRGGBB Set the color used on authentication failure. (default: 0xdc322f) USAGE Run the waylock executable to lock the session. All monitors will be blanked with the -init-color. Typing causes the color to change to the -input-color. If -input-alt-color is set, the typing color will alter- nate between this and the former. Esc or Ctrl-U clears all current in- put, while backspace deletes the last UTF-8 codepoint. To unlock the session, type your password and press Enter. If the pass- word is correct, waylock will unlock the session and exit. Otherwise, the color will change to the -fail-color and you may try again. In order to automatically run waylock after a certain amount of time with no input or before sleep, the swayidle(1) utility or a similar program may be used. See the swayidle(1) man page for details. AUTHORS Maintained by Isaac Freund <mail@isaacfreund.com> who is assisted by open source contributors. For more information about waylock's develop- ment, see https://codeberg.org/ifreund/waylock. SEE ALSO pam(8), swayidle(1) https://codeberg.org/ifreund/w... 2025-04-13 WAYLOCK(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | USAGE | AUTHORS | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=waylock&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>