2010-07-16 17:47:42 +02:00
|
|
|
i3lock - improved screen locker
|
|
|
|
===============================
|
2022-05-20 11:37:04 +02:00
|
|
|
[i3lock](https://i3wm.org/i3lock/) is a simple screen locker like slock.
|
2019-03-18 21:22:34 +01:00
|
|
|
After starting it, you will see a white screen (you can configure the
|
|
|
|
color/an image). You can return to your screen by entering your password.
|
2009-03-11 22:17:00 +01:00
|
|
|
|
2010-07-16 17:47:42 +02:00
|
|
|
Many little improvements have been made to i3lock over time:
|
2009-03-11 22:17:00 +01:00
|
|
|
|
2010-07-16 17:47:42 +02:00
|
|
|
- i3lock forks, so you can combine it with an alias to suspend to RAM
|
|
|
|
(run "i3lock && echo mem > /sys/power/state" to get a locked screen
|
|
|
|
after waking up your computer from suspend to RAM)
|
2009-03-11 22:17:00 +01:00
|
|
|
|
2010-07-16 18:22:33 +02:00
|
|
|
- You can specify either a background color or a PNG image which will be
|
2019-09-24 22:26:39 +02:00
|
|
|
displayed while your screen is locked. Note that i3lock is not an image
|
|
|
|
manipulation software. If you need to resize the image to fill the screen
|
|
|
|
or similar, use existing tooling to do this before passing it to i3lock.
|
2009-03-11 22:17:00 +01:00
|
|
|
|
2010-07-16 17:47:42 +02:00
|
|
|
- You can specify whether i3lock should bell upon a wrong password.
|
2009-03-11 22:17:00 +01:00
|
|
|
|
2010-07-16 17:47:42 +02:00
|
|
|
- i3lock uses PAM and therefore is compatible with LDAP etc.
|
2017-04-15 14:41:32 +02:00
|
|
|
On OpenBSD i3lock uses the bsd_auth(3) framework.
|
2009-03-11 22:17:00 +01:00
|
|
|
|
2019-03-08 20:35:48 +01:00
|
|
|
Install
|
|
|
|
-------
|
2019-03-08 20:29:33 +01:00
|
|
|
|
2019-03-18 21:22:34 +01:00
|
|
|
See [the i3lock home page](https://i3wm.org/i3lock/).
|
2019-03-08 20:29:33 +01:00
|
|
|
|
2010-07-16 17:47:42 +02:00
|
|
|
Requirements
|
|
|
|
------------
|
2012-10-26 20:40:20 +02:00
|
|
|
- pkg-config
|
2010-07-16 17:47:42 +02:00
|
|
|
- libxcb
|
|
|
|
- libxcb-util
|
|
|
|
- libpam-dev
|
|
|
|
- libcairo-dev
|
2012-03-15 12:35:24 +01:00
|
|
|
- libxcb-xinerama
|
2017-11-18 10:44:58 +01:00
|
|
|
- libxcb-randr
|
2012-03-15 12:47:40 +01:00
|
|
|
- libev
|
2012-03-15 13:50:51 +01:00
|
|
|
- libx11-dev
|
2012-10-26 20:24:55 +02:00
|
|
|
- libx11-xcb-dev
|
2015-02-12 00:37:23 +01:00
|
|
|
- libxkbcommon >= 0.5.0
|
|
|
|
- libxkbcommon-x11 >= 0.5.0
|
2020-01-02 15:05:05 +01:00
|
|
|
- libxcb-image
|
|
|
|
- libxcb-xrm
|
2009-03-11 22:17:00 +01:00
|
|
|
|
|
|
|
Running i3lock
|
|
|
|
-------------
|
2022-02-27 23:55:57 +01:00
|
|
|
|
|
|
|
To test i3lock, you can directly run the `i3lock` command. To get out of it,
|
|
|
|
enter your password and press enter.
|
|
|
|
|
|
|
|
For a more permanent setup, we strongly recommend using `xss-lock` so that the
|
|
|
|
screen is locked *before* your laptop suspends:
|
|
|
|
|
|
|
|
```
|
|
|
|
xss-lock --transfer-sleep-lock -- i3lock --nofork
|
|
|
|
```
|
2013-02-10 15:18:54 +01:00
|
|
|
|
2017-04-15 14:41:32 +02:00
|
|
|
On OpenBSD the `i3lock` binary needs to be setgid `auth` to call the
|
|
|
|
authentication helpers, e.g. `/usr/libexec/auth/login_passwd`.
|
|
|
|
|
2018-12-02 12:15:46 +01:00
|
|
|
Building i3lock
|
|
|
|
---------------
|
|
|
|
We recommend you use the provided package from your distribution. Do not build
|
|
|
|
i3lock unless you have a reason to do so.
|
|
|
|
|
|
|
|
First install the dependencies listed in requirements section, then run these
|
|
|
|
commands (might need to be adapted to your OS):
|
|
|
|
```
|
|
|
|
rm -rf build/
|
|
|
|
mkdir -p build && cd build/
|
|
|
|
|
2022-05-20 11:37:04 +02:00
|
|
|
meson .. -Dprefix=/usr
|
|
|
|
ninja
|
2018-12-02 12:15:46 +01:00
|
|
|
```
|
|
|
|
|
2013-02-10 15:18:54 +01:00
|
|
|
Upstream
|
|
|
|
--------
|
2014-12-26 21:02:58 +01:00
|
|
|
Please submit pull requests to https://github.com/i3/i3lock
|