libinput-debug-events(1) libinput Manual libinput-debug-events(1)

# [NAME](#NAME)

libinput-debug-events - debug helper for libinput

# [SYNOPSIS](#SYNOPSIS)

**libinput debug-events *\[options]***

**libinput debug-events *\[options]* --udev *<seat>***

**libinput debug-events *\[options]* \[--device] */dev/input/event0* \[*/dev/input/event1*...]**

# [DESCRIPTION](#DESCRIPTION)

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.

# [OPTIONS](#OPTIONS)

[**--compress-motion-events**](#compress)

Compress repeated motion, axis, scroll, and gesture update events into a single line. This only takes effect if stdout is a TTY.

[**--device */dev/input/event0***](#device)

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

[**--grab**](#grab)

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

[**--help**](#help)

Print help

[**--quiet**](#quiet)

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

[**--show-keycodes**](#show)

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>***](#udev)

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

[**--verbose**](#verbose)

Use verbose output

## [libinput configuration options](#libinput_configuration_options)

[**--apply-to="pattern"**](#apply-to=_pattern_)

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

[**--disable-sendevents="pattern"**](#disable-sendevents=_pattern_)

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

[**--enable-drag|--disable-drag**](#enable-drag_)

Enable or disable tap-and-drag

[**--enable-drag-lock|--disable-drag-lock**](#enable)

Enable (in timeout mode) or disable drag-lock **--enable-drag-lock=\[sticky|timeout]** Enable drag-lock in sticky or timeout mode

[**--enable-dwt|--disable-dwt**](#enable~2)

Enable or disable disable-while-typing

[**--enable-dwtp|--disable-dwtp**](#enable~3)

Enable or disable disable-while-trackpointing

[**--enable-left-handed|--disable-left-handed**](#enable~4)

Enable or disable left handed button configuration

[**--enable-middlebutton|--disable-middlebutton**](#enable~5)

Enable or disable middle button emulation

[**--enable-natural-scrolling|--disable-natural-scrolling**](#enable~6)

Enable or disable natural scrolling

[**--enable-scroll-button-lock|--disable-scroll-button-lock**](#enable~7)

Enable or disable the scroll button lock

[**--enable-tap|--disable-tap**](#enable~8)

Enable or disable tap-to-click

[**--set-area="x1/y1 x2/y2"**](#set)

Set the tablet area to the rectangle described by the two points x1/y1 and x2/y2. All coordinates must be in the range \[0.0, 1.0].

[**--set-calibration="1.0 0.0 0.0 0.0 1.0 0.0"**](#set~2)

Set the first 6 elements of a 3x3 matrix to use for calibration. The third row of the matrix is always "0.0 0.0 0.1".

[**--set-click-method=\[none|clickfinger|buttonareas\]**](#set~3)

Set the desired click method

[**--set-clickfinger-map=\[lrm|lmr\]**](#set~4)

Set button mapping for clickfinger

[**--set-custom-points="<value>;...;<value>"**](#set~5)

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.

[**--set-custom-step=<value>**](#set~6)

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

[**--set-custom-type=\[fallback|motion|scroll\]**](#set~7)

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

[**--set-eraser-button-button=\[BTN\_STYLUS|BTN\_STYLUS2|BTN\_STYLUS3\]**](#set~8)

Sets the eraser button button to the given tablet tool button. Only takes effect if combined with **--set-eraser-button-mode=on-button-down.**

[**--set-eraser-button-mode=\[default|on-button-down\]**](#set~9)

Sets the eraser button mode to the given mode.

[**--set-pressure-range=<min>:<max>**](#set~10)

Set the tablet tool pressure range to min:max. min and max must be in range \[0.0, 1.0].

[**--set-profile=\[adaptive|flat|custom\]**](#set~11)

Set pointer acceleration profile

[**--set-rotation-angle=<degrees>**](#set~12)

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

[**--set-scroll-button=BTN\_MIDDLE**](#set~13)

Set the button to the given button code

[**--set-scroll-method=\[none|twofinger|edge|button|circular\]**](#set~14)

Set the desired scroll method

[**--set-sendevents=\[disabled|enabled|disabled-on-external-mouse\]**](#set~15)

Set the given sendevents mode. This option overrides **--disable-sendevents="pattern"** for any devices it matches via the **--apply-to="pattern"** option.

[**--set-speed=<value>**](#set~16)

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

[**--set-tap-map=\[lrm|lmr\]**](#set~17)

Set button mapping for tapping

# [NOTES](#NOTES)

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

# [LIBINPUT](#LIBINPUT)

Part of the [**libinput(1)**](/man/os/libinput/libinput.1) suite

libinput 1.32.0

---

Document: libinput-debug-events(1) from libinput 1.32.0-r0 (Chainguard OS)
Source: https://gitlab.freedesktop.org/libinput/libinput