| 
				
					
						 | 
			11 years ago | |
|---|---|---|
| .clang-format | 11 years ago | |
| .gitignore | 14 years ago | |
| .travis.yml | 11 years ago | |
| CHANGELOG | 11 years ago | |
| LICENSE | 15 years ago | |
| Makefile | 11 years ago | |
| README.md | 11 years ago | |
| cursors.h | 11 years ago | |
| i3lock.1 | 11 years ago | |
| i3lock.c | 11 years ago | |
| i3lock.h | 11 years ago | |
| i3lock.pam | 15 years ago | |
| unlock_indicator.c | 11 years ago | |
| unlock_indicator.h | 11 years ago | |
| xcb.c | 11 years ago | |
| xcb.h | 12 years ago | |
| xinerama.c | 11 years ago | |
| xinerama.h | 14 years ago | |
		
			
				
				README.md
			
		
		
	
	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.5.0
 - libxkbcommon-x11 >= 0.5.0
 
Running i3lock
Simply invoke the 'i3lock' command. To get out of it, enter your password and press enter.
Upstream
Please submit pull requests to https://github.com/i3/i3lock