1libinput-measure-touchpad-tap(1)libinput Manuallibinput-measure-touchpad-tap(1)
2
3
4

NAME

6       libinput-measure-touchpad-tap  - measure tap-to-click properties of de‐
7       vices
8

SYNOPSIS

10       libinput measure touchpad-tap  [--help]  [--format=<format>]  [/dev/in‐
11       put/event0]
12

DESCRIPTION

14       The  libinput  measure  touchpad-tap  tool  measures  properties of the
15       tap-to-click behavior of the user. This is an  interactive  tool.  When
16       executed,  the tool will prompt the user to interact with the touchpad.
17       On termination, the tool prints a summary of the tap interactions seen.
18       This data should be attached to any tap-related bug report.
19
20       For  a  full description on how libinput's tap-to-click behavior works,
21       see the online documentation here: https://wayland.freedesktop.org/lib
22       input/doc/latest/tapping.html
23
24       This  is  a  debugging tool only, its output may change at any time. Do
25       not rely on the output.
26
27       This tool usually needs to be  run  as  root  to  have  access  to  the
28       /dev/input/eventX nodes.
29

OPTIONS

31       If a device node is given, this tool opens that device node. Otherwise,
32       this tool searches for the first node that looks like  a  touchpad  and
33       uses that node.
34
35       --help  Print help
36
37       --format=summary|dat
38               Specify  the  data  format  to  be  printed. The default (or if
39               --format is omitted) is "summary". See section DATA FORMATS
40
41

DATA FORMATS

43       This section describes the data formats printed with the --format  com‐
44       mandline argument. Note that any of the output may change at any time.
45
46       summary
47           The  summary  format  prints  a summary of the data collected. This
48           format is useful to get a quick overview of a user's tapping behav‐
49           ior and why some taps may or may not be detected.
50
51       dat
52           The  dat  format prints the touch sequence data (raw and processed)
53           in column-style format, suitable for processing by other tools such
54           as  gnuplot(1).  The data is aligned in one row per touch with each
55           column containing a separate data  entry.   libinput-measure-touch‐
56           pad-tap  prints  comments  at  the top of the file to describe each
57           column.
58
59           WARNING: The data contained in the output is grouped  by  different
60           sort orders. For example, the first few columns may list tap infor‐
61           mation in the 'natural' sort order (i.e.  as  they  occurred),  the
62           data in the next few columns may list tap information sorted by the
63           delta time between touch down  and  touch  up.   Comparing  columns
64           across  these  group  boundaries will compare data of two different
65           touch points and result in invalid analysis.
66

BUGS

68       This tool does not take finger pressure into account. The  tap  it  de‐
69       tects  may  be  different  to  those detected by libinput if libinput's
70       pressure thresholds  differ  significantly  to  the  kernel's  pressure
71       thresholds.
72

LIBINPUT

74       Part of the libinput(1) suite
75
76
77
78libinput 1.19.2                               libinput-measure-touchpad-tap(1)
Impressum