libinput-debug-gui - visual debug helper for libinput
libinput debug-gui [options]
libinput debug-gui [options] --udev
<seat>
libinput debug-gui [options] [--device]
/dev/input/event0
The libinput debug-gui tool creates a libinput context and
a full-screen GTK window to visualize events processed by libinput. This
tool exclusively grabs pointing devices and stops them from interacting with
the rest of the GUI.
Hit Esc to exit this tool.
This is a debugging tool only, its output or behavior may change
at any time. Do not rely on the output or the behavior.
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 with the path backend. The --device argument
may be omitted.
- --grab
- Exclusively grab all opened devices. This will prevent events from being
delivered to the host system.
- --help
- Print help
- --udev
<seat>
- Use the udev backend to listen for device notifications on the given seat.
The default behavior is equivalent to --udev "seat0".
- --verbose
- Use verbose output
For libinput configuration options, see
libinput-debug-events(1)
- Cursor
movement
- The cursor is displayed as black triangle. Various markers are displayed
in light grey to help debug cusor positioning. The cursor movement is the
one as seen by libinput and may not match the cursor movement of the
display server.
- Button
testing
- Four oblongs are displayed at the bottom. The top three are left, middle,
right, the bottom one is for any other button and displays the button name
on press.
- Scrolling
- The green oblongs show the scrolling in continuous space, the smaller red
oblongs the scroll steps in discrete steps.
- Gestures
- A set of four horizontal black rings show swipe gestures, with the number
of detected fingers filled in. A set of two black rings show pinch
gestures, filled when events are detected.
- Touch and absolute mouse
events
- Touch and absolute mouse events are displayed as red and blue circles,
respectively, at the touch point or absolute position.
- Tablet
tools
- Events from tablet tools show a cyan square at the proximity-in and
proximity-out positions. The tool position is shown as circle and
increases in radius with increasing pressure or distance. Pressure and
distance are also shown in the vertical bar south-east of center. Where
tilt is available, the circle changes to an ellipsis to indicate the tilt
angle. Relative events from the tablet tool are displayed as a yellow
snake, always starting from the center of the window on proximity in.
Button events are displayed in the bottom-most button oblong, with the
name of the button displayed on press.
- Tablet
pads
- Button events are displayed in the bottom-most button oblong, with the
name of the button displayed on press. Ring and strip events are displayed
in the yellow 'IO' symbol, with the position and the number of the
ring/strip filled in when events are available.
- Kernel
events
- Left of the center is a blue ring to debug kernel relative events (REL_X
and REL_Y). Each unit is displayed as one arrow in the respective
direction. Right of the center is a blue oblong representing the most
recently-used touch device. Touch events are displayed as they are read
from the kernel.
Events shown by this tool may not correspond to the events seen by
a different user of libinput. This tool initializes a separate context.