Overview

Debugging applications under Wayland can sometimes feel opaque compared to X11. In this post, I detail how to capture protocol logs and inspect compositor state using standard debugging tools.

Protocol Tracing

To inspect raw Wayland protocol messages, set the WAYLAND_DEBUG environment variable before running your client:

WAYLAND_DEBUG=1 ./my-wayland-app