Skip to main content
Version: 2.0 (dev)

Wayland Protocols

Wayland protocols somewm advertises in its registry. Versions are the maximum announced; clients negotiate down as needed.

Core

ProtocolVersion
wl_compositor6
wl_subcompositor
wl_seat
wl_output
wl_data_device_manager

Shells and decorations

ProtocolVersionPurpose
xdg_shell6Application windows and popups
zwlr_layer_shell_v13Bars, docks, wallpapers, notifications
xdg_activation_v1Focus and urgency requests
zwlr_foreign_toplevel_management_v1External window list and control
ext_session_lock_manager_v1Lockscreens
zxdg_decoration_manager_v1Client/server decoration negotiation
org_kde_kwin_server_decorationLegacy decoration fallback

Clipboard and capture

ProtocolVersionPurpose
zwlr_data_control_manager_v1Clipboard without focus
zwp_primary_selection_device_manager_v1Middle-click paste
zwlr_screencopy_manager_v1Pixel screen capture
zwlr_export_dmabuf_manager_v1GPU-buffer screen capture

Input

ProtocolVersionPurpose
wp_cursor_shape_v11Named cursors
zwp_pointer_gestures_v1Touchpad swipe, pinch, hold
zwp_pointer_constraints_v1Lock or confine pointer
zwp_relative_pointer_manager_v1Relative motion deltas
zwp_virtual_keyboard_manager_v1Virtual keyboard input
zwlr_virtual_pointer_manager_v1Virtual pointer input

Output

ProtocolVersionPurpose
zxdg_output_manager_v1Logical output geometry
zwlr_output_manager_v1Output config (kanshi, wlr-randr)
zwlr_output_power_management_v1DPMS
zwlr_gamma_control_manager_v1Gamma ramps (gammastep, wlsunset)

Rendering and buffers

ProtocolVersionPurpose
zwp_linux_dmabuf_v15GPU buffer sharing
wp_linux_drm_syncobj_manager_v11Explicit GPU sync
wp_viewporterSurface crop and scale
wp_single_pixel_buffer_manager_v1Solid-color buffers
wp_fractional_scale_manager_v11Non-integer HiDPI scaling
wp_alpha_modifier_v1Per-surface alpha
wp_presentationFrame timestamps
wl_drmLegacy, superseded by zwp_linux_dmabuf_v1

Idle

ProtocolVersionPurpose
ext_idle_notifier_v1Idle-timeout notifications
zwp_idle_inhibit_manager_v1Idle inhibition

XWayland

Included by default, started on demand for the first X11 client. Disable with meson setup -Dxwayland=disabled.