Go to file
Simon Kämpe f368bbd006 Added missing #ifndef NOLIBCAIRO
Needed to compile without libcairo.
2012-01-07 11:47:20 +00:00
debian debian: add libxcb-xinerama0-dev as build-dependency 2012-01-04 00:12:57 +00:00
LICENSE update debian packaging, update copyright 2011-07-13 17:06:46 +02:00
Makefile Implement Xinerama support (not used yet) 2012-01-03 23:10:56 +00: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 change ALL the copyrights! 2012-01-03 18:20:37 +00:00
i3lock.c Bugfix: Check for waiting X11 events before entering the event loop 2012-01-05 22:27:01 +00: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 change ALL the copyrights! 2012-01-03 18:20:37 +00:00
ucs2_to_utf8.h Initial commit of the XCB rewrite of i3lock 2010-07-16 17:35:51 +02:00
unlock_indicator.c Added missing #ifndef NOLIBCAIRO 2012-01-07 11:47:20 +00:00
unlock_indicator.h Properly free timeouts, move one of the timeouts to unlock_indicator.c 2012-01-03 22:18:33 +00:00
xcb.c Fix a few memory leaks 2012-01-03 22:31:16 +00:00
xcb.h Implement Xinerama support (not used yet) 2012-01-03 23:10:56 +00:00
xinerama.c Implement Xinerama support (not used yet) 2012-01-03 23:10:56 +00:00
xinerama.h draw the unlock indicator in the middle of every screen 2012-01-04 00:10:36 +00: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.