https://github.com/swaywm/swaylock

Screen locker for Wayland
https://github.com/swaywm/swaylock

sway wayland wlroots

Last synced: 3 months ago
JSON representation

Screen locker for Wayland

• Host: GitHub
• URL: https://github.com/swaywm/swaylock
• Owner: swaywm
• License: mit
• Created: 2019-01-14T02:25:09.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-12-22T09:57:33.000Z (6 months ago)
• Last Synced: 2024-01-06T23:54:06.853Z (5 months ago)
• Topics: sway, wayland, wlroots
• Language: C
• Size: 308 KB
• Stars: 694
• Watchers: 20
• Forks: 172
• Open Issues: 79
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-wayland - swaylock - Screen locker for Wayland (Screen Locking)
• awesome-stars - swaylock
• awesome-hyprland - swaylock
• awesome-starred - swaylock - Screen locker for Wayland (C)
• awesome-stars - swaywm/swaylock - Screen locker for Wayland (C)
• awesome-linux-ricing - swaylock - for Wayland (Screen Lock / Utilities)
• awesome-stars - swaywm/swaylock - Screen locker for Wayland (C)

README

        
# swaylock

swaylock is a screen locking utility for Wayland compositors. It is compatible

with any Wayland compositor which implements the ext-session-lock-v1 Wayland

protocol.

See the man page, [swaylock(1)](swaylock.1.scd), for instructions on using swaylock.

## Release Signatures

Releases are signed with [E88F5E48](https://keys.openpgp.org/search?q=34FF9526CFEF0E97A340E2E40FDE7BE0E88F5E48)

and published [on GitHub](https://github.com/swaywm/swaylock/releases). swaylock

releases are managed independently of sway releases.

## Installation

### From Packages

Swaylock is available in many distributions. Try installing the "swaylock"

package for yours.

### Compiling from Source

Install dependencies:

* meson \*

* wayland

* wayland-protocols \*

* libxkbcommon

* cairo

* gdk-pixbuf2 \*\*

* pam (optional)

* [scdoc](https://git.sr.ht/~sircmpwn/scdoc) (optional: man pages) \*

* git \*

_\* Compile-time dep_  

_\*\* Optional: required for background images other than PNG_

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.