• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..03-May-2022-

m4/H27-Oct-2020-1,4591,387

pam/H27-Oct-2020-75

CHANGELOGH A D27-Oct-20207.8 KiB198156

I3LOCK_VERSIONH A D27-Oct-20205 21

LICENSEH A D13-Jul-20111.5 KiB2822

Makefile.amH A D23-Feb-2020901 5948

Makefile.inH A D27-Oct-202040.5 KiB1,076956

README.mdH A D20-Jan-20202.1 KiB7760

aclocal.m4H A D27-Oct-202057.4 KiB1,5901,436

ar-libH A D27-Oct-20205.7 KiB272211

compileH A D27-Oct-20207.2 KiB349259

config.guessH A D27-Oct-202047.3 KiB1,6681,457

config.h.inH A D27-Oct-20205.9 KiB242167

config.subH A D27-Oct-202030.9 KiB1,7941,637

configureH A D27-Oct-2020296.5 KiB10,1218,426

configure.acH A D27-Oct-20206 KiB156124

cursors.hH A D16-Mar-2015109 96

depcompH A D27-Oct-202023 KiB792502

dpi.cH A D05-Jul-20202.8 KiB11062

dpi.hH A D10-Oct-2018556 234

i3lock.1H A D21-Jul-20194.6 KiB174141

i3lock.cH A D25-Oct-202043.2 KiB1,321941

i3lock.hH A D05-Jul-2020663 169

install-shH A D27-Oct-202015.3 KiB530346

missingH A D27-Oct-20206.7 KiB216143

randr.cH A D05-Jul-20208.7 KiB298216

randr.hH A D10-Jan-2018294 1813

unlock_indicator.cH A D05-Jul-202013.7 KiB379254

unlock_indicator.hH A D05-Jul-20201.2 KiB3022

xcb.cH A D05-Jul-202013.7 KiB435336

xcb.hH A D10-Jan-2018801 1813

README.md

1i3lock - improved screen locker
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
7Many little improvements have been made to i3lock over time:
8
9- i3lock forks, so you can combine it with an alias to suspend to RAM
10  (run "i3lock && echo mem > /sys/power/state" to get a locked screen
11   after waking up your computer from suspend to RAM)
12
13- You can specify either a background color or a PNG image which will be
14  displayed while your screen is locked. Note that i3lock is not an image
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
18- You can specify whether i3lock should bell upon a wrong password.
19
20- i3lock uses PAM and therefore is compatible with LDAP etc.
21  On OpenBSD i3lock uses the bsd_auth(3) framework.
22
23Install
24-------
25
26See [the i3lock home page](https://i3wm.org/i3lock/).
27
28Requirements
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
45Running i3lock
46-------------
47Simply invoke the 'i3lock' command. To get out of it, enter your password and
48press enter.
49
50On OpenBSD the `i3lock` binary needs to be setgid `auth` to call the
51authentication helpers, e.g. `/usr/libexec/auth/login_passwd`.
52
53Building i3lock
54---------------
55We recommend you use the provided package from your distribution. Do not build
56i3lock unless you have a reason to do so.
57
58First install the dependencies listed in requirements section, then run these
59commands (might need to be adapted to your OS):
60```
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
77