1
2i3lock(1)                        User Manuals                        i3lock(1)
3
4
5

NAME

7       i3lock - slightly improved version of slock
8
9

SYNOPSIS

11       i3lock [-v] [-n] [-b] [-d] [-i image.xpm] [-c color] [-t]
12
13

DESCRIPTION

15       i3lock  locks  your screen by making it white (default). To quit i3lock
16       just enter your password.
17
18

DIFFERENCES TO SLOCK

20       i3lock improves slock by making it fork() and therefore combinable with
21       commands to suspend your computer. Additionally, instead of turning off
22       your screen via DPMS and/or displaying a black screen, i3lock  displays
23       a  white  (or  colored in your favorite color) screen so you can see if
24       your computer failed to resume from suspend or if your screen  is  just
25       locked.  Since  version 1.1, i3lock can display images in XPM file for‐
26       mat. Also, when  entering  a  wrong  password,  i3lock  does  not  call
27       XBell().  This is important because i3lock/slock think you've entered a
28       password when resuming from suspend, at least sometimes.
29
30       Since version 1.0, i3lock supports PAM.
31
32

OPTIONS

34       -v, --version
35              Display the version of your i3lock
36
37
38       -n, --nofork
39              Don't fork after starting.
40
41
42       -b, --beep
43              Enable beeping. Be sure to not do this when  you  are  about  to
44              annoy  other  people,  like when opening your laptop in a boring
45              lecture.
46
47
48       -d, --dpms
49              Enable turning off your screen using DPMS. Note that,  when  you
50              do not specify this option, DPMS will turn off your screen after
51              15 minutes of inactivity anyways (if you did not disable this in
52              your X server).
53
54
55       -i, --image
56              Display  the  given XPM image instead of a blank screen. You can
57              convert an image to XPM by using convert(1) from ImageMagick  or
58              GIMP for example.
59
60
61       -c, --color
62              Turns  the  screen  into the given color instead of white. Color
63              must be given in 6-byte format: rrggbb (i.e. ff0000 is red)
64
65
66       -t, --tile
67              If an image is specified (via -i)  it  will  display  the  image
68              tiled  all  over the screen (if it is a multi-monitor setup, the
69              image is visible on all screens).
70
71

AUTHOR

73       Michael Stapelberg <michael+i3lock at stapelberg dot de>
74
75       Jan-Erik Rediger <badboy at archlinux.us>
76
77       forked from slock-0.9 by Anselm R Garbe <garbeam at gmail dot com>
78
79
80
81Linux                             AUGUST 2009                        i3lock(1)
Impressum