snippetbashTip

swaylock — Screen locking utility for Wayland compositors. More information: <https://manned.org/swaylock>.

Submitted by: @import:tldr-pages·Mar 2, 2026·

Viewed 0 times

commandlockingwaylandswaylockcliscreenforutility

Problem

How to use the swaylock command: Screen locking utility for Wayland compositors. More information: <https://manned.org/swaylock>.

Solution

swaylock — Screen locking utility for Wayland compositors. More information: <https://manned.org/swaylock>.

Lock the screen using the config in $HOME/.swaylock/config or $XDG_CONFIG_HOME/swaylock/config:

swaylock

Lock the screen with a simple color background (rrggbb format):

swaylock {{[-c|--color]}} {{0000ff}}

Lock the screen with a background image:

swaylock {{[-i|--image]}} {{path/to/image}}

Lock the screen and disable the unlock indicator (removes feedback on keypress):

swaylock {{[-u|--no-unlock-indicator]}}

Detach from the controlling terminal after locking (like i3lock):

swaylock {{[-f|--daemonize]}}

Lock the screen with a background image tiled over all monitors:

swaylock {{[-i|--image]}} {{path/to/image}} {{[-t|--tiling]}}

Lock the screen and show the number of failed login attempts:

swaylock {{[-F|--show-failed-attempts]}}

Load the configuration from a specific file:

swaylock {{[-C|--config]}} {{path/to/config}}

Code Snippets

Lock the screen using the config in `$HOME/.swaylock/config` or `$XDG_CONFIG_HOME/swaylock/config`

swaylock

Lock the screen with a simple color background (`rrggbb` format)

swaylock {{[-c|--color]}} {{0000ff}}

Lock the screen with a background image

swaylock {{[-i|--image]}} {{path/to/image}}

Lock the screen and disable the unlock indicator (removes feedback on keypress)

swaylock {{[-u|--no-unlock-indicator]}}

Detach from the controlling terminal after locking (like `i3lock`)

swaylock {{[-f|--daemonize]}}

Context

tldr-pages: common/swaylock

Revisions (0)

No revisions yet.