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
7       devices
8

SYNOPSIS

10       libinput    measure    touchpad-tap    [--help]     [--format=<format>]
11       [/dev/input/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
46summary
47    The  summary format prints a summary of the data collected. This format is
48    useful to get a quick overview of a user's tapping behavior and  why  some
49    taps may or may not be detected.
50
51dat
52    The  dat format prints the touch sequence data (raw and processed) in col‐
53    umn-style format, suitable for processing by  other  tools  such  as  gnu‐
54    plot(1).   The  data is aligned in one row per touch with each column con‐
55    taining a separate data entry.  libinput-measure-touchpad-tap prints  com‐
56    ments at the top of the file to describe each column.
57
58    WARNING:  The  data  contained  in the output is grouped by different sort
59    orders. For example, the first few columns may list tap information in the
60    'natural' sort order (i.e. as they occured), the data in the next few col‐
61    umns may list tap information sorted by the delta time between touch  down
62    and  touch  up.  Comparing columns across these group boundaries will com‐
63    pare data of two different touch points and result in invalid analysis.
64

BUGS

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

LIBINPUT

72       Part of the libinput(1) suite
73
74
75
76libinput 1.13.2                               libinput-measure-touchpad-tap(1)
Impressum