1libinput-debug-events(1) libinput Manual libinput-debug-events(1)
2
6 libinput-debug-events - debug helper for libinput
7
9 libinput debug-events [options]
10 libinput debug-events [options] --udev <seat>
12 libinput debug-events [options] [--device] /dev/input/event0 [/dev/in‐
14 put/event1...]
15
17 The libinput debug-events tool creates a libinput context and prints
18 all events from these devices.
19 This is a debugging tool only, its output may change at any time. Do
21 not rely on the output.
22 This tool usually needs to be run as root to have access to the
24 /dev/input/eventX nodes.
25
27 --device /dev/input/event0
28 Use the given device(s) with the path backend. The --device ar‐
29 gument may be omitted.
30 --grab Exclusively grab all opened devices. This will prevent events
32 from being delivered to the host system.
33 --help Print help
35 --quiet Only print libinput messages, don't print anything from this
37 tool. This is useful in combination with --verbose for internal
38 state debugging.
39 --show-keycodes
41 Key events shown by this tool are partially obfuscated to avoid
42 passwords and other sensitive information showing up in the
43 output. Use the --show-keycodes argument to make all keycodes
44 visible.
45 --udev <seat>
47 Use the udev backend to listen for device notifications on the
48 given seat. The default behavior is equivalent to --udev
49 "seat0".
50 --verbose
52 Use verbose output
53 libinput configuration options
55 --apply-to="pattern"
56 Configuration options are only applied where the device name
57 matches the pattern. This pattern has no effect on the --dis‐
58 able-sendevents option.
59 --disable-sendevents="pattern"
61 Set the send-events option to disabled for the devices matching
62 patterns. This option is not affected by the --apply-to="pat‐
63 tern" option.
64 --enable-tap|--disable-tap
66 Enable or disable tap-to-click
67 --enable-drag|--disable-drag
69 Enable or disable tap-and-drag
70 --enable-drag-lock|--disable-drag-lock
72 Enable or disable drag-lock
73 --enable-natural-scrolling|--disable-natural-scrolling
75 Enable or disable natural scrolling
76 --enable-left-handed|--disable-left-handed
78 Enable or disable left handed button configuration
79 --enable-middlebutton|--disable-middlebutton
81 Enable or disable middle button emulation
82 --enable-dwt|--disable-dwt
84 Enable or disable disable-while-typing
85 --enable-dwtp|--disable-dwtp
87 Enable or disable disable-while-trackpointing
88 --enable-scroll-button-lock|--disable-scroll-button-lock
90 Enable or disable the scroll button lock
91 --set-click-method=[none|clickfinger|buttonareas]
93 Set the desired click method
94 --set-scroll-method=[none|twofinger|edge|button]
96 Set the desired scroll method
97 --set-scroll-button=BTN_MIDDLE
99 Set the button to the given button code
100 --set-profile=[adaptive|flat|custom]
102 Set pointer acceleration profile
103 --set-speed=<value>
105 Set pointer acceleration speed. The allowed range is [-1, 1].
106 This only applies to the flat or adaptive profile.
107 --set-custom-points="<value>;...;<value>"
109 Sets the n points defining a custom acceleration function The
110 points are defined in a semicolon-separated list of floating
111 point non-negative numbers. Defaults to "0.0;1.0". This only
112 applies to the custom profile.
113 --set-custom-step=<value>
115 Sets the distance along the x-axis between each point, starting
116 from 0. Defaults to 1.0. This only applies to the custom pro‐
117 file.
118 --set-custom-type=[fallback|motion|scroll]
120 Sets the type of the custom acceleration function. Defaults to
121 fallback. This only applies to the custom profile.
122 --set-tap-map=[lrm|lmr]
124 Set button mapping for tapping
125
127 Events shown by this tool may not correspond to the events seen by a
128 different user of libinput. This tool initializes a separate context.
129
131 Part of the libinput(1) suite
132libinput 1.23.0 libinput-debug-events(1)