mirror of https://github.com/alols/xcape.git synced 2026-09-10 09:56:14 -04:00

Vital part of my keyboard config.

Go to file

Alex Roper 071788b544 Fixed issue where when given an invalid map like 'Control_L' or 'Control_L=Escape;Control_R' it would add a mapping from that key to NULL list of to keys. Now it will simply skip over the mapping with no to and print a WARNING that the statement has no effect to stderr. Also, where before if only nop mappings were provided the program would still run/fork into the background; it now will only run if at least one mapping with an effect is provided.		2012-10-25 14:16:31 -04:00
LICENSE	First commit	2012-03-31 23:02:17 +02:00
Makefile	Fix Makefile for BSD make	2012-10-15 00:19:52 +04:00
README.md	Update documentation.	2012-10-25 13:08:57 +02:00
xcape.c	Fixed issue where when given an invalid map like 'Control_L' or 'Control_L=Escape;Control_R' it would add a mapping from that key to NULL list of to keys. Now it will simply skip over the mapping with no to and print a WARNING that the statement has no effect to stderr. Also, where before if only nop mappings were provided the program would still run/fork into the background; it now will only run if at least one mapping with an effect is provided.	2012-10-25 14:16:31 -04:00

README.md

XCAPE

xcape allows you to use a modifier key as another key when pressed and released on its own. Note that it is slightly slower than pressing the original key, because the pressed event does not occur until the key is released. The default behaviour is to generate the Escape key when Left Control is pressed and released on its own. (If you don't understand why anybody would want this, I'm guessing that Vim is not your favourite text editor ;)

Minimal building instructions

$ sudo apt-get install git gcc make libx11-dev libxtst-dev
$ mkdir xcape
$ cd xcape
$ git clone https://github.com/alols/xcape.git .
$ make

Usage

$ xcape [-d] [-t <timeout ms>] [-e <map-expression>]

`-d`

Debug mode. Does not fork into the background.

`-t <timeout ms>`

If you hold a key longer than this timeout, xcape will not generate a key event. Default is 50 ms.

`-e <map-expression>`

The expression has the grammar 'ModKey=Key[|OtherKey][;NextExpression]'

The list of key names is found in the header file X11/keysymdef.h (remove the XK_ prefix).

Example

xcape -e 'Shift_L=Escape;Control_L=Control_L|O'

This will make Left Shift generate Escape when pressed and released on it's own, and Left Control generate Ctrl-O combination when pressed and released on it's own.

Contact

Find the latest version at https://github.com/alols/xcape

The author can be reached at albin dot olsson at gmail dot com