Go to file
Michael Stapelberg e03e93fd1b optimization: render to pixmap which is used as background for the window
Before this commit, the background color (white by default) was visible for
about 100ms until the image was drawn. This flickering is now eliminated.

Also, we don’t need to handle Expose-events anymore, as X11 will use the
window’s background pixmap automatically.
2011-04-02 19:49:38 +02:00
debian update debian packaging 2011-03-13 20:38:32 +01:00
LICENSE Initial commit of the XCB rewrite of i3lock 2010-07-16 17:35:51 +02:00
Makefile add i3lock.pam (installed as /etc/pam.d/i3lock) which includes 'login' (Thanks Семён) 2011-01-20 10:36:03 +01: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 manpage: add missing "specify" (Thanks xeen) 2010-07-21 01:46:59 +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.