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