Provided by: lisgd_0.3.4-1_amd64 
NAME
lisgd - libinput synthetic gesture daemon
SYNOPSIS
lisgd [-d devicepath] [-g gesturespec]... [-t threshold] [-m timeoutms] [-o orientation]
[-w width] [-h height] [-r degreesofleniency] [-v]
DESCRIPTION
lisgd (or libinput synthetic gesture daemon) lets you bind gestures based on libinput
touch events to run specific commands to execute. For example, dragging left to right with
one finger could execute a particular command like launching a terminal. Directional L-R,
R-L, U-D, and D-U gestures and diagnol LD-RU, RD-LU, UR-DL, UL-DR gestures are supported
with 1 through n fingers and can be bound to the screen's edges and/or made sensitive to
the distance of the gesture.
Unlike other libinput gesture daemons, lisgd uses touch events to recognize synthetic
swipe gestures rather than using the libinput's gesture events. The advantage of this is
that the synthetic gestures you define via lisgd can be used on touchscreens, which normal
libinput gestures don't support.
This program was built for use on the Pinephone however it could be used in general for
any device that supports touch events, like laptop touchscreens or similar. You may want
to adjust the threshold depending on the device you're using.
OPTIONS
-d, -d devicepath
Path of the dev filesystem device to monitor (like /dev/input/event1).
-g, -g nfingers,gesture,edge,distance,actmode,command
Allows you to bind a gesture wherein nfingers is an integer, gesture is one of
{LR,RL,DU,UD,DLUR,URDL,ULDR,DLUR}, edge is one of * (any), N (none), L (left), R
(right), T (top), B (bottom), TL (top left), TR (top right), BL (bottom left), BR
(bottom right) and distance is one of * (any), S (short), M (medium), L (large),
actmode is R (release) for normal mode and P (pressed) for pressed mode (but this
field may be omitted entirely for backward compatibility), command is the shell
command to be executed.
The -g option can be used multiple times to bind multiple gestures.
-m, -m timeoutms
Number of milliseconds gestures must be performed within to be registered. After
the timeoutms value; the gesture won't be registered.
-o, -o orientation
Number of 90-degree rotations to translate gestures by. Can be set to 0-3. For
example using 1; a L-R gesture would become a U-D gesture. Meant to be used for
screen-rotation.
-r, -r degreesofleniency
Number of degrees offset each 45-degree interval may still be recognized within.
Maximum value is 45. Default value is 15. E.g. U-D is a 180 degree gesture but with
15 degrees of leniency will be recognized between 165-195 degrees.
-t, -t distancethreshold
Threshold in libinput units (pixels) after which a gesture registers. Defaults to
125.
-T, -T distancethreshold_pressed
Threshold in libinput units (pixels) after which a gesture registers when fingers
are not lifted. Defaults to 60.
-w, -w screnwidth
Allows you to specify the width of the screen area to be used for edge-based
gestures. Should be used in conjunction with -h. If unset, and either the DISPLAY
or WAYLAND_DISPLAY env var is set, X/Wayland dynamic screen geometry detection will
be used instead.
-h, -h screenheight
Allows you to specify the height of the screen area to be used for edge-based
gestures. Should be used in conjunction with -w. If unset, and either the DISPLAY
or WAYLAND_DISPLAY env var is set, X/Wayland dynamic screen geometry detection will
be used instead.
-v Enables verbose mode which prints debugging messages.
SEE ALSO
lisgd was built as part of Sxmo; an project to create a Pinephone UI out of simple and
suckless programs. See: http://sr.ht/mil/Sxmo
AUTHOR
lisgd is written by Miles Alan <m@milesalan.com>
CONTRIBUTING
Bugs and feature dicussions can be sent to ~mil/sxmo-devel@lists.sr.ht
LISGD(1)