8 releases

0.3.5 Feb 25, 2022
0.3.4 Jan 28, 2022
0.3.3 Aug 13, 2020
0.3.2 Jun 17, 2020
0.1.1 Mar 17, 2020

#1141 in GUI

MIT license

37KB
873 lines

waylock

Waylock is a simple screenlocker for wayland compositors. It takes inspiration from slock with its minimalistic feature set, but is implemented in rust for first class safety and security.

Waylock will work with any wayland compositor implementing the wlr-layer-shell and wlr-input-inhibitor protocols. In general, this means wlroots-based compositors such as river or sway.

Installation

Waylock can be manually compiled from source or installed using cargo. Note that waylock links against libpam and you will need the relevant headers installed on your system to build waylock.

$ cargo install waylock --locked

It is also packaged for several linux distributions: https://repology.org/project/waylock/versions.

Usage

USAGE:
    waylock [FLAGS] [OPTIONS]

FLAGS:
    -h, --help       Prints help information
        --one-way    Never revert the color after input or failure.
    -v               Enable verbose logging, repeat for greater effect (e.g. -vvv).
    -V, --version    Prints version information

OPTIONS:
        --config <FILE>
            Use an alternative config file. [default: $XDG_CONFIG_HOME/waylock/waylock.toml]

        --fail-color <COLOR>
            Set the color of the lock screen on authentication failure. [default: #ff0000]

        --fail-command <COMMAND>
            Command to run on authentication failure. Executed with `sh -c <COMMAND>`.

        --init-color <COLOR>
            Set the initial color of the lock screen. [default: #ffffff]

        --input-color <COLOR>
            Set the color of the lock screen after input is received. [default: #0000ff]

Detaching waylock from the controlling terminal to run as a daemon can be accomplished with setsid(1).

Some examples of what --fail-command could be used for include:

  • Playing an alarm sound
  • Taking a screenshot with the webcam
  • Sending an email to yourself

Dependencies

~5–11MB
~111K SLoC