---
syntax: markdown
tags: [tldr, common]
source: https://github.com/tldr-pages/tldr.git
---
# 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}}`
