2019-01-13 20:24:33 -06:00
|
|
|
# swaylock
|
|
|
|
|
|
|
|
|
|
swaylock is a screen locking utility for Wayland compositors. It is compatible
|
2022-11-27 07:18:29 -06:00
|
|
|
with any Wayland compositor which implements the ext-session-lock-v1 Wayland
|
|
|
|
|
protocol.
|
2019-01-13 20:24:33 -06:00
|
|
|
|
2023-11-26 15:36:30 -06:00
|
|
|
See the man page, [swaylock(1)](swaylock.1.scd), for instructions on using swaylock.
|
2019-01-13 20:24:33 -06:00
|
|
|
|
|
|
|
|
## Release Signatures
|
|
|
|
|
|
2022-02-02 08:48:45 -06:00
|
|
|
Releases are signed with [E88F5E48](https://keys.openpgp.org/search?q=34FF9526CFEF0E97A340E2E40FDE7BE0E88F5E48)
|
2019-01-17 10:17:36 -06:00
|
|
|
and published [on GitHub](https://github.com/swaywm/swaylock/releases). swaylock
|
2019-01-13 20:24:33 -06:00
|
|
|
releases are managed independently of sway releases.
|
|
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
### From Packages
|
|
|
|
|
|
2019-01-17 10:17:36 -06:00
|
|
|
Swaylock is available in many distributions. Try installing the "swaylock"
|
|
|
|
|
package for yours.
|
2019-01-13 20:24:33 -06:00
|
|
|
|
|
|
|
|
### Compiling from Source
|
|
|
|
|
|
|
|
|
|
Install dependencies:
|
|
|
|
|
|
|
|
|
|
* meson \*
|
|
|
|
|
* wayland
|
|
|
|
|
* wayland-protocols \*
|
2019-01-16 09:20:45 -06:00
|
|
|
* libxkbcommon
|
2019-01-13 20:24:33 -06:00
|
|
|
* cairo
|
|
|
|
|
* gdk-pixbuf2 \*\*
|
|
|
|
|
* pam (optional)
|
|
|
|
|
* [scdoc](https://git.sr.ht/~sircmpwn/scdoc) (optional: man pages) \*
|
|
|
|
|
* git \*
|
|
|
|
|
|
2022-02-02 08:53:24 -06:00
|
|
|
_\* Compile-time dep_
|
|
|
|
|
_\*\* Optional: required for background images other than PNG_
|
2019-01-13 20:24:33 -06: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.
|
