2019-01-14 03:24:33 +01:00
|
|
|
# swaylock
|
|
|
|
|
|
|
|
|
|
swaylock is a screen locking utility for Wayland compositors. It is compatible
|
2022-02-02 16:43:58 +01:00
|
|
|
with any Wayland compositor which implements one of the following Wayland
|
|
|
|
|
protocols:
|
2019-01-14 03:24:33 +01:00
|
|
|
|
2022-02-02 16:43:58 +01:00
|
|
|
- ext-session-lock-v1, or
|
|
|
|
|
- wlr-layer-shell and wlr-input-inhibitor
|
2019-01-14 03:24:33 +01:00
|
|
|
|
2019-01-14 03:30:20 +01:00
|
|
|
See the man page, `swaylock(1)`, for instructions on using swaylock.
|
2019-01-14 03:24:33 +01:00
|
|
|
|
|
|
|
|
## Release Signatures
|
|
|
|
|
|
2022-02-02 15:48:45 +01:00
|
|
|
Releases are signed with [E88F5E48](https://keys.openpgp.org/search?q=34FF9526CFEF0E97A340E2E40FDE7BE0E88F5E48)
|
2019-01-17 17:17:36 +01:00
|
|
|
and published [on GitHub](https://github.com/swaywm/swaylock/releases). swaylock
|
2019-01-14 03:24:33 +01:00
|
|
|
releases are managed independently of sway releases.
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
### From Packages
|
|
|
|
|
|
2019-01-17 17:17:36 +01:00
|
|
|
Swaylock is available in many distributions. Try installing the "swaylock"
|
|
|
|
|
package for yours.
|
2019-01-14 03:24:33 +01:00
|
|
|
|
|
|
|
|
### Compiling from Source
|
|
|
|
|
|
|
|
|
|
Install dependencies:
|
|
|
|
|
|
|
|
|
|
* meson \*
|
|
|
|
|
* wayland
|
|
|
|
|
* wayland-protocols \*
|
2019-01-16 16:20:45 +01:00
|
|
|
* libxkbcommon
|
2019-01-14 03:24:33 +01:00
|
|
|
* cairo
|
|
|
|
|
* gdk-pixbuf2 \*\*
|
|
|
|
|
* pam (optional)
|
|
|
|
|
* [scdoc](https://git.sr.ht/~sircmpwn/scdoc) (optional: man pages) \*
|
|
|
|
|
* git \*
|
|
|
|
|
|
2022-02-02 15:53:24 +01:00
|
|
|
_\* Compile-time dep_
|
|
|
|
|
_\*\* Optional: required for background images other than PNG_
|
2019-01-14 03:24:33 +01:00
|
|
|
|
|
|
|
|
Run these commands:
|
|
|
|
|
|
|
|
|
|
meson build
|
|
|
|
|
ninja -C build
|
|
|
|
|
sudo ninja -C build install
|
|
|
|
|
|
|
|
|
|
On systems without PAM, you need to suid the swaylock binary:
|
|
|
|
|
|
|
|
|
|
sudo chmod a+s /usr/local/bin/swaylock
|
|
|
|
|
|
|
|
|
|
Swaylock will drop root permissions shortly after startup.
|
