summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md86
1 files changed, 22 insertions, 64 deletions
diff --git a/README.md b/README.md
index cb2cde9..dec2154 100644
--- a/README.md
+++ b/README.md
@@ -1,76 +1,34 @@
1i3lock - improved screen locker 1## i3lock-extended
2===============================
3[i3lock](https://i3wm.org/i3lock/)> is a simple screen locker like slock.
4After starting it, you will see a white screen (you can configure the
5color/an image). You can return to your screen by entering your password.
6 2
7Many little improvements have been made to i3lock over time: 3i3lock-extended is a fork of i3lock (https://github.com/i3/i3lock).
4It was started by Simeon Simeonov (https://simeon.simeonov.no) as a small hack,
5implementing a LED-clock on top of an existing and robust screensaver.
8 6
9- i3lock forks, so you can combine it with an alias to suspend to RAM 7i3lock-extended adds some additional functionality and is a free-software
10 (run "i3lock && echo mem > /sys/power/state" to get a locked screen 8licenced under the GPL3+. Most of the code is copyrighted by Michael Stapelberg
11 after waking up your computer from suspend to RAM) 9under a different license. See LICENSE for more information\!
12 10
13- You can specify either a background color or a PNG image which will be 11The original README.md file from i3lock, containing installation instructions
14 displayed while your screen is locked. Note that i3lock is not an image 12can be found as INSTALL.md.
15manipulation software. If you need to resize the image to fill the screen
16or similar, use existing tooling to do this before passing it to i3lock.
17 13
18- You can specify whether i3lock should bell upon a wrong password.
19 14
20- i3lock uses PAM and therefore is compatible with LDAP etc. 15### Additional features
21 On OpenBSD i3lock uses the bsd_auth(3) framework.
22 16
23Install 17- LED-clock
24------- 18- Digital clock
19- Elapsed time since activation
20- Display-text
25 21
26See [the i3lock home page](https://i3wm.org/i3lock/). 22i3lock-extended includes all of the original code and features of i3lock.
27 23
28Requirements 24Please refer to the manual page for more details and information about the different parameters\!
29------------
30- pkg-config
31- libxcb
32- libxcb-util
33- libpam-dev
34- libcairo-dev
35- libxcb-xinerama
36- libxcb-randr
37- libev
38- libx11-dev
39- libx11-xcb-dev
40- libxkbcommon >= 0.5.0
41- libxkbcommon-x11 >= 0.5.0
42- libxcb-image
43- libxcb-xrm
44 25
45Running i3lock
46-------------
47Simply invoke the 'i3lock' command. To get out of it, enter your password and
48press enter.
49 26
50On OpenBSD the `i3lock` binary needs to be setgid `auth` to call the 27### Versioning
51authentication helpers, e.g. `/usr/libexec/auth/login_passwd`.
52 28
53Building i3lock 29i3lock-extended will merge the changes and fixes coming to i3lock in the
54--------------- 30future.
55We recommend you use the provided package from your distribution. Do not build
56i3lock unless you have a reason to do so.
57 31
58First install the dependencies listed in requirements section, then run these 32In order to create more clarity the version format for i3lock-extended will be:
59commands (might need to be adapted to your OS): 33\<extended version starting from 1>.\<i3lock version that is merged in\>[a-z
60``` 34extended revision if used].
61autoreconf --force --install
62
63rm -rf build/
64mkdir -p build && cd build/
65
66../configure \
67 --prefix=/usr \
68 --sysconfdir=/etc \
69 --disable-sanitizers
70
71make
72```
73
74Upstream
75--------
76Please submit pull requests to https://github.com/i3/i3lock