Skip to content

Latest commit

 

History

History
31 lines (28 loc) · 1.49 KB

config.md

File metadata and controls

31 lines (28 loc) · 1.49 KB

Gestures configuration

Location

The configuration is looked for at $XDG_CONFIG_HOME/gestures.kdl and then at $XDG_CONFIG_HOME/gestures/gestures.kdl. If XDG_CONFIG_HOME is not set, $HOME/.config is used instead.

Format

The configuration format (since 0.5.0) uses kdl.

// Swipe requires a direction and fingers field at least
// direction can be one of "nw", "n", "ne", "w", "any", "e", "sw", "s", or "se"
// fingers is the number of fingers used to trigger the action
// start, update, and end are all optional. They are executed with `sh -c` and are executed when
// the gesture is started, recieves an update event and ends.
//
// In all of the fields which execute a shell command, `delta_x`, `delta_y`, `delta_angle`, and `scale` are replaced
// with the delta in the x and y directions, the angle delta and the scale (movement farther apart or closer together)
// of the gesture. If they are used for an action in which they do not make sense (e.g. using 
// `scale` in the swipe gesture, 0.0 is used as the value.)
//
swipe direction="s" fingers=4 start="<command>" update="<command>" end="<command>"

// pinch direction can be "in", "out", "clockwise" or "counter-clockwise". Other fields are the same as for
// the swipe gesture
//
pinch direction="out" fingers=3 start="<command>" update="<command>" end="<command>"

// Hold only has one action, rather than start, end and update, because it does not
// make much sense to update it.
hold fingers=3 action="<command>"