Files
slock/README.md
Sravan Balaji d617e8e10f terminalkeys patch
- Apply terminalkeys patch
- Update README with link to terminalkeys patch
- Add diff to patches folder
2020-12-11 11:03:22 -05:00

37 lines
1.5 KiB
Markdown

# slock - simple screen locker
Sravan's custom build of slock. Original slock build by suckless team found here: [https://tools.suckless.org/slock/](https://tools.suckless.org/slock/)
## Requirements
In order to build slock you need the Xlib header files.
## Installation
Edit [config.mk](config.mk) to match your local setup (slock is installed into
the /usr/local namespace by default).
Afterwards enter the following command to build and install slock
(if necessary as root):
```
make clean install
```
## Running slock
Simply invoke the `slock` command. To get out of it, enter your password.
## Configuration
The configuration of slock is done by creating a custom config.h and (re)compiling the source code.
## Patches
Most patches can be found on the suckless website: [https://tools.suckless.org/slock/patches/](https://tools.suckless.org/slock/patches/)
* [capscolor](https://tools.suckless.org/slock/patches/capscolor/) - Introduces an additional color to indicate the state of Caps Lock.
* [mediakeys](https://tools.suckless.org/slock/patches/mediakeys/) - Allows use of media keys while screen is locked
* [message](https://tools.suckless.org/slock/patches/message/) - This patch lets you add a message to your lock screen. You can place a default message in `config.h`, and you can also pass a message with `-m message`
* [terminalkeys](https://tools.suckless.org/slock/patches/terminalkeys/) - Add key commands that are commonly used in terminal applications (in particular the login prompt) to slock