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.
86 lines
2.7 KiB
86 lines
2.7 KiB
.TH LISGD 1 |
|
|
|
.SH NAME |
|
lisgd \- libinput synthetic gesture daemon |
|
|
|
.SH SYNOPSIS |
|
.B lisgd |
|
[\fB\-d\fR \fIdevicepath\fR] |
|
[\fB\-g\fR \fIgesturespec\fR]... |
|
[\fB\-t\fR \fIthreshold\fR] |
|
[\fB\-m\fR \fItimeoutms\fR] |
|
[\fB\-o\fR \fIorientation\fR] |
|
[\fB\-r\fR \fIdegreesofleniency\fR] |
|
[\fB\-v] |
|
|
|
|
|
.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 |
|
diagnol 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 \-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. |
|
|
|
.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 \-o ", " \-o\ orientation\fR |
|
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. |
|
|
|
.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 \-t ", " \-t\ distancethreshold\fR |
|
Threshold in libinput units (pixels) after which a gesture registers. Defaults |
|
to 300. |
|
|
|
.TP |
|
.BR \-v \fR |
|
Enables verbose mode which prints debugging messages. |
|
|
|
|
|
.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
|
|
|