1libinput-measure-touchpad-tap(1)libinput Manuallibinput-measure-touchpad-tap(1)
2
6 libinput-measure-touchpad-tap - measure tap-to-click properties of de‐
7 vices
8
10 libinput measure touchpad-tap [--help] [--format=<format>] [/dev/in‐
11 put/event0]
12
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 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 This is a debugging tool only, its output may change at any time. Do
25 not rely on the output.
26 This tool usually needs to be run as root to have access to the
28 /dev/input/eventX nodes.
29
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 --help Print help
36 --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
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 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 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 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
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
74 Part of the libinput(1) suite
75libinput 1.21.0 libinput-measure-touchpad-tap(1)