libinput-debug-events - debug helper for libinput

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  libinput configuration options  NOTES  LIBINPUT 


libinput−debug−events − debug helper for libinput


libinput debug−events [options]

libinput debug−events [options] −−udev <seat>

libinput debug−events [options] [−−device] /dev/input/event0 [/dev/input/event1...]


The libinput debug−events tool creates a libinput context and prints all events from these devices.

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.


−−device /dev/input/event0

Use the given device(s) with the path backend. The −−device argument may be omitted.


Exclusively grab all opened devices. This will prevent events from being delivered to the host system.


Print help


Only print libinput messages, don’t print anything from this tool. This is useful in combination with --verbose for internal state debugging.


Key events shown by this tool are partially obfuscated to avoid passwords and other sensitive information showing up in the output. Use the −−show−keycodes argument to make all keycodes visible.

−−udev <seat>

Use the udev backend to listen for device notifications on the given seat. The default behavior is equivalent to −−udev "seat0".


Use verbose output

libinput configuration options


Configuration options are only applied where the device name matches the pattern. This pattern has no effect on the −−disable-sendevents option.


Set the send-events option to disabled for the devices matching patterns. This option is not affected by the −−apply-to="pattern" option.


Enable or disable tap-to-click


Enable or disable tap-and-drag


Enable or disable drag-lock


Enable or disable natural scrolling


Enable or disable left handed button configuration


Enable or disable middle button emulation


Enable or disable disable-while-typing


Enable or disable disable-while-trackpointing


Enable or disable the scroll button lock


Set the desired click method


Set the desired scroll method


Set the button to the given button code


Set pointer acceleration profile


Set pointer acceleration speed. The allowed range is [-1, 1]. This only applies to the flat or adaptive profile.


Sets the n points defining a custom acceleration function The points are defined in a semicolon-separated list of floating point non-negative numbers. Defaults to "0.0;1.0". This only applies to the custom profile.


Sets the distance along the x-axis between each point, starting from 0. Defaults to 1.0. This only applies to the custom profile.


Sets the type of the custom acceleration function. Defaults to fallback. This only applies to the custom profile.


Set button mapping for tapping


Set the rotation angle in degrees (0 to 360).


Events shown by this tool may not correspond to the events seen by a different user of libinput. This tool initializes a separate context.


Part of the libinput(1) suite

Updated 2024-01-29 - |