The world's most popular non-default computer lockscreen.
Go to file
koebi a305e622a6 Run authentification in different process
When having i3bar in “hide” mode, it could previously be brought up
while the authentication was running. This is not 100% fixed with this
change, but a lot better, as the normal “raise i3lock to the top”
behavior is not blocked now anymore.

fixes #895
2013-09-19 06:18:41 +02:00
.gitignore add .gitignore 2012-04-07 19:41:50 +02:00
CHANGELOG update changelog for 2.5 2013-06-09 11:41:33 +02:00
LICENSE update debian packaging, update copyright 2011-07-13 17:06:46 +02:00
Makefile add xcb-atom to pkg-config calls 2013-06-09 11:48:39 +02:00
README README: refer to cr.i3wm.org for patches 2013-02-10 15:18:54 +01:00
cursors.h Move static byte arrays to xcb.c (fixes compilation warnings) 2010-07-20 23:06:54 +02:00
i3lock.1 Small improvements to manual page. 2013-09-09 04:34:16 +02:00
i3lock.c Run authentification in different process 2013-09-19 06:18:41 +02:00
i3lock.h Only output text when in debug mode (fixes problems with xautolock) 2012-03-26 19:54:47 +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
unlock_indicator.c Fix centering the indicator in the no-xinerama case 2013-03-29 10:14:01 +01:00
unlock_indicator.h Use (void) instead of () for functions without args (Thanks fernandotcl) 2012-04-01 12:28:28 +02:00
xcb.c Set window name 2013-04-11 22:54:48 +02:00
xcb.h use libxkbcommon for input handling 2012-10-26 20:39:59 +02:00
xinerama.c bugfix: free(reply) to avoid memory leak 2012-10-26 20:21:53 +02:00
xinerama.h Use (void) instead of () for functions without args (Thanks fernandotcl) 2012-04-01 12:28:28 +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
- libxcb
- libxcb-util
- libpam-dev
- libcairo-dev
- libxcb-xinerama
- libev
- libx11-dev
- libx11-xcb-dev
- libxkbfile-dev
- libxkbcommon >= 0.2.0

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

Upstream
--------
Please submit patches to http://cr.i3wm.org/