libinput-measure-touchpad-tap (1) - Linux Man Pages
libinput-measure-touchpad-tap: measure tap-to-click properties of devices
libinput-measure-touchpad-tap - measure tap-to-click properties of devices
SYNOPSISlibinput measure touchpad-tap [--help] [--format=<format>] [/dev/input/event0]
The 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 report.
For a full description on how libinput's tap-to-click behavior works, see the online documentation here: https://wayland.freedesktop.org/libinput/doc/latest/tapping.html
This is a debugging tool only, its output may change at any time. Do not rely on the output.
OPTIONSIf 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 node.
- Print help
Specify the data format to be printed. The default (or if
is omitted) is "summary". See section
DATA FORMATSThis section describes the data formats printed with the --format commandline argument. Note that any of the output may change at any time.
- The summary 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.
WARNING: 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.
BUGSThis 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.
LIBINPUTPart of the libinput(1) suite