This is my fork of sxiv's lisgd.
https://git.sr.ht/~mil/lisgd
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
79 lines
2.5 KiB
79 lines
2.5 KiB
4 years ago
|
.TH LISGD 1
|
||
|
|
||
|
.SH NAME
|
||
|
lisgd \- libinput synthetic gesture daemon
|
||
|
|
||
|
.SH SYNOPSIS
|
||
|
.B lisgd
|
||
|
[\fB\-t\fR \fIthreshold\fR]
|
||
|
[\fB\-d\fR \fIdegreesofleniency\fR]
|
||
|
[\fB\-m\fR \fItimeoutms\fR]
|
||
|
[\fB\-o\fR \fIorientation\fR]
|
||
|
[\fB\-v\fR \fIverbose\fR]
|
||
|
[\fB\-g\fR \fIgesturespec\fR]...
|
||
|
|
||
|
|
||
|
.SH DESCRIPTION
|
||
|
.B 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
|
||
|
diagnoal LD-RU, RD-LU, UR-DL, UL-DR gestures are supported with 1 through
|
||
|
n fingers.
|
||
|
|
||
|
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.
|
||
|
|
||
|
|
||
|
.SH OPTIONS
|
||
|
.TP
|
||
|
.BR \-d ", " \-d\ devicepath\fR
|
||
|
Path of the dev filesystem device to monitor (like /dev/input/event1).
|
||
|
|
||
|
.TP
|
||
|
.BR \-t ", " \-t\ distancethreshold\fR
|
||
|
Threshold in libinput units (pixels) after which a gesture registers. Defaults
|
||
|
to 300.
|
||
|
|
||
|
.TP
|
||
|
.BR \-r ", " \-r\ degreesofleniency\fR
|
||
|
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.
|
||
|
|
||
|
.TP
|
||
|
.BR \-m ", " \-m\ timeoutms\fR
|
||
|
Number of milliseconds gestures must be performed within to be registered. After
|
||
|
the timeoutms value; the gesture won't be registered.
|
||
|
|
||
|
.TP
|
||
|
.BR \-v \fR
|
||
|
Enables verbose mode which prints debugging messages.
|
||
|
|
||
|
.TP
|
||
|
.BR \-g ", " \-g\ nfingers,gesture,command\fR
|
||
|
Allow you to bind a gesture wherein nfingers is an integer, gesture is
|
||
|
one of {LR,RL,DU,UD,DLUR,URDL,ULDR,DLUR}, and the shell command to be executed.
|
||
|
|
||
|
The -g option can be used multiple times to bind multiple gestures.
|
||
|
|
||
|
.SH 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
|
||
|
|
||
|
.SH AUTHOR
|
||
|
.BR lisgd
|
||
|
is written by Miles Alan <m@milesalan.com>
|
||
|
|
||
|
.SH CONTRIBUTING
|
||
|
Bugs and feature dicussions can be sent to ~mil/sxmo-devel@lists.sr.ht
|