git.sur5r.net Git - i3/i3lock/blob - README

   1 i3lock - slightly improved screen locker based on slock
   2 ============================
   3 i3lock improves slock by making it fork() and therefore combinable with
   4 commands to suspend your computer. Additionally, instead of turning off
   5 your screen via DPMS and/or displaying a black screen, i3lock displays a
   6 white screen so you can see if your computer failed to resume from suspend
   7 or if your screen is just locked. Also, when entering a wrong password,
   8 i3lock does not call XBell(). This is important because i3lock/slock think
   9 you’ve entered a password when resuming from suspend, at least sometimes.
  10
  11 i3lock was forked from slock-0.9
  12
  13 Requirements
  14 ------------
  15 In order to build i3lock you need the Xlib header files.
  16
  17
  18 Installation
  19 ------------
  20 Edit config.mk to match your local setup (slock is installed into
  21 the /usr/local namespace by default).
  22
  23 Afterwards enter the following command to build and install slock
  24 (if necessary as root):
  25
  26     make clean install
  27
  28
  29 Running i3lock
  30 -------------
  31 Simply invoke the 'i3lock' command. To get out of it, enter your password.