Provided by: lisgd_0.3.7-1_amd64 bug

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,DRUL,URDL,ULDR},  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)