xev

xev [-event type] [-id window] [-root] [options]

xev is an X11 event monitoring utility that displays all events received by a window. When launched, it opens a small window and prints detailed information about every X event that occurs within it, including key presses, mouse movements, button clicks, window exposure, and focus changes.The tool is primarily used for debugging X11 input issues and discovering keycodes for keyboard configuration. Each event is printed with full details including keycodes, key symbols, coordinates, modifier states, and timestamps. This makes it invaluable for setting up key bindings in window managers or diagnosing input problems.Events can be filtered by type using the -event option to show only keyboard, mouse, button, or motion events. The -id option monitors events on a specific existing window, while -root captures events on the root window for display-wide monitoring.

-display DISPLAY

X server to contact.

Event type filter (can be specified multiple times).

Monitor events on an existing window by ID.

Monitor events on the root window.

Name to assign to the created window.

Window size and position.

Border width for the window.

Backing store type (NotUseful, WhenMapped, Always). Default NotUseful.

Display window in reverse video.

keyboard - Key press/release eventsmouse - All pointer eventsbutton - Button press/release eventsmotion - Pointer motion eventsexpose - Expose eventsvisibility - Visibility change eventsstructure - Window structure eventssubstructure - Substructure eventsfocus - Focus change eventsproperty - Property change eventscolormap - Colormap eventsowner_grab_button - Owner grab button eventsrandr - RandR events

X11 only, not Wayland. Creates visible window. Output is verbose.

xev is part of the standard X11 utilities. It's essential for understanding X input events and configuring key bindings.

xdotool(1), xmodmap(1), xinput(1)