Section: libinput Manual (1)
libinput-measure-touchpad-tap - measure tap-to-click properties of devices
libinput measure touchpad-tap [--help] [--format=<format>] [/dev/input/event0]
libinput measure touchpad-tap
tool measures properties of the tap-to-click behavior of the user. This is
an interactive tool. When executed, the tool will prompt the user to
interact with the touchpad. On termination, the tool prints a summary of the
tap interactions seen. This data should be attached to any tap-related bug
For a full description on how libinput's tap-to-click behavior works, see
the online documentation here:
This is a debugging tool only, its output may change at any time. Do not
rely on the output.
This tool usually needs to be run as root to have access to the
If a device node is given, this tool opens that device node. Otherwise, this
tool searches for the first node that looks like a touchpad and uses that
Specify the data format to be printed. The default (or if
is omitted) is "summary". See section
This section describes the data formats printed with the
commandline argument. Note that any of the output may change at any time.
format prints a summary of the data collected. This format is useful to
get a quick overview of a user's tapping behavior and why some taps may or
may not be detected.
format prints the touch sequence data (raw and processed) in column-style
format, suitable for processing by other tools such as
The data is aligned in one row per touch with each column containing a
separate data entry.
prints comments at the top of the file to describe each column.
The data contained in the output is grouped by different sort orders. For
example, the first few columns may list tap information in the 'natural'
sort order (i.e. as they occured), the data in the next few columns may list
tap information sorted by the delta time between touch down and touch up.
Comparing columns across these group boundaries will compare data of two
different touch points and result in invalid analysis.
This tool does not take finger pressure into account. The tap it detects may
be different to those detected by libinput if libinput's pressure thresholds
differ significantly to the kernel's pressure thresholds.
Part of the