wev
Wayland event viewer for input debugging
TLDR
Monitor all events
$ wev
Filter by interface$ wev -f [wl_keyboard]
Filter specific events$ wev -f [wl_keyboard]:[key]
Exclude events$ wev -F [wl_keyboard]:[key]
Write keymap to file$ wev -M [path/to/file]
Print globals$ wev -g
SYNOPSIS
wev [OPTIONS]
DESCRIPTION
wev opens an xdg-shell toplevel window on the default Wayland display (via the WAYLAND_DISPLAY environment variable), then prints events associated with that window. It displays keyboard, mouse, touch, and other input events as they occur, similar to xev for X11.This tool is useful for debugging Wayland input handling, discovering keycodes, and understanding Wayland protocol events.
PARAMETERS
-f INTERFACE[:EVENT]
Include only specified interface/events. May be specified multiple times.-F INTERFACE[:EVENT]
Exclude specified interface/events. May be specified multiple times.-M FILE
Write keymap to file-g
Print Wayland globals
INSTALL
sudo apt install wev
sudo dnf install wev
sudo pacman -S wev
sudo apk add wev
sudo zypper install wev
nix profile install nixpkgs#wev
CAVEATS
Wayland only. Output can be verbose. Some events may require specific compositor support.