Go to file
Michael Stapelberg 1e7349e739 update debian packaging, update copyright 2011-07-13 17:06:46 +02:00
debian update debian packaging, update copyright 2011-07-13 17:06:46 +02:00
LICENSE update debian packaging, update copyright 2011-07-13 17:06:46 +02:00
Makefile makefile: respect and use CPPFLAGS / LIBS (Thanks Kacper) 2011-07-13 16:56:27 +02:00
README Make it possible to build i3lock without cairo. 2010-10-06 23:37:31 +02:00
cursors.h Move static byte arrays to xcb.c (fixes compilation warnings) 2010-07-20 23:06:54 +02:00
i3lock.1 update debian packaging, update copyright 2011-07-13 17:06:46 +02:00
i3lock.c optimization: render to pixmap which is used as background for the window 2011-04-02 19:49:38 +02:00
i3lock.pam use 'auth include login' instead of '@include login', the latter is debian-specific (Thanks mseed) 2011-01-23 00:11:51 +01:00
keysym2ucs.c Bugfix: Handle numpad keys correctly (Thanks Pascal) 2010-11-08 14:43:07 +01:00
keysym2ucs.h Initial commit of the XCB rewrite of i3lock 2010-07-16 17:35:51 +02:00
ucs2_to_utf8.c bump copyright 2011-03-13 20:23:39 +01:00
ucs2_to_utf8.h Initial commit of the XCB rewrite of i3lock 2010-07-16 17:35:51 +02:00
xcb.c optimization: render to pixmap which is used as background for the window 2011-04-02 19:49:38 +02:00
xcb.h optimization: render to pixmap which is used as background for the window 2011-04-02 19:49:38 +02:00

README

i3lock - improved screen locker
===============================
i3lock is a simple screen locker like slock. 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.

Many little improvements have been made to i3lock over time:

- 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)

- You can specify either a background color or a PNG image which will be
  displayed while your screen is locked.

- You can specify whether i3lock should bell upon a wrong password.

- i3lock uses PAM and therefore is compatible with LDAP etc.

Requirements
------------
- pkg-config (or you can rewrite the Makefile by hand if you want to avoid it)
- libxcb
- libxcb-util
- libpam-dev
- libcairo-dev

Running i3lock
-------------
Simply invoke the 'i3lock' command. To get out of it, enter your password.

Building i3lock
-------------
If you don't want to build against libcairo run "make NOLIBCAIRO=y", without
libcairo displaying images is not possible.