Provided by: libinput-tools_1.25.0-1ubuntu3.1_amd64 bug

NAME

       libinput-measure-touchpad-tap - measure tap-to-click properties of devices

SYNOPSIS

       libinput measure touchpad-tap [--help] [--format=<format>] [/dev/input/event0]

DESCRIPTION

       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.

       This tool usually needs to be run as root to have access to the /dev/input/eventX nodes.

OPTIONS

       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 node.

       --help  Print help

       --format=summary|dat
               Specify  the data format to be printed. The default (or if --format is omitted) is "summary". See
               section DATA FORMATS

DATA FORMATS

       This section describes the data formats printed with the --format commandline argument. Note that any  of
       the output may change at any time.

       summary
           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.

       dat
           The dat format prints the touch sequence data (raw and processed) in  column-style  format,  suitable
           for processing by other tools such as gnuplot(1).  The data is aligned in one row per touch with each
           column containing a separate data entry.  libinput-measure-touchpad-tap 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 occurred), 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.

BUGS

       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.

LIBINPUT

       Part of the libinput(1) suite

libinput 1.25.0                                                                 libinput-measure-touchpad-tap(1)