Skip to main content
Version: 2.1

Wayland Protocols

Interfaces advertised by SomeWM 2.1.0. Versions below were checked with wlroots 0.20.2. Clients can bind an older version. Renderer-dependent interfaces are noted separately.

Core​

ProtocolVersion
wl_compositor6
wl_shm2
wl_subcompositor1
wl_seat9
wl_output4
wl_data_device_manager3

Shells and decorations​

ProtocolVersionPurpose
xdg_wm_base6Application windows and popups
zwlr_layer_shell_v13Bars, docks, wallpapers, notifications
xdg_activation_v11Focus and urgency requests
zwlr_foreign_toplevel_manager_v13External window list and control
ext_session_lock_manager_v11Lockscreens
zxdg_decoration_manager_v11Client/server decoration negotiation
org_kde_kwin_server_decoration_manager1Legacy decoration fallback

Clipboard and capture​

ProtocolVersionPurpose
zwlr_data_control_manager_v12Clipboard without focus
zwp_primary_selection_device_manager_v11Middle-click paste
zwlr_screencopy_manager_v13Pixel screen capture
zwlr_export_dmabuf_manager_v11GPU-buffer screen capture

SomeWM 2.1.0 does not advertise ext_image_copy_capture_manager_v1 or ext_output_image_capture_source_manager_v1. Capture tools must use one of the supported interfaces above.

Input​

ProtocolVersionPurpose
wp_cursor_shape_manager_v11Named cursors
zwp_pointer_gestures_v13Touchpad swipe, pinch, hold
zwp_pointer_constraints_v11Lock or confine pointer
zwp_relative_pointer_manager_v11Relative motion deltas
zwp_virtual_keyboard_manager_v11Virtual keyboard input
zwlr_virtual_pointer_manager_v12Virtual pointer input
zwp_tablet_manager_v21Tablet tools and pads

Output​

ProtocolVersionPurpose
zxdg_output_manager_v13Logical output geometry
zwlr_output_manager_v14Output config (kanshi, wlr-randr)
zwlr_output_power_manager_v11DPMS
zwlr_gamma_control_manager_v11Gamma ramps (gammastep, wlsunset)

Rendering and buffers​

ProtocolVersionPurpose
zwp_linux_dmabuf_v15GPU buffer sharing
wp_linux_drm_syncobj_manager_v11Explicit GPU sync
wp_viewporter1Surface crop and scale
wp_single_pixel_buffer_manager_v11Solid-color buffers
wp_fractional_scale_manager_v11Non-integer HiDPI scaling
wp_alpha_modifier_v11Per-surface alpha
wp_presentation2Frame timestamps
wl_drm2Legacy, superseded by zwp_linux_dmabuf_v1

wl_drm and zwp_linux_dmabuf_v1 require a renderer with DMA-BUF support. Explicit sync additionally requires a DRM file descriptor and timeline support in both the renderer and backend. These are absent from a Pixman headless session.

Idle​

ProtocolVersionPurpose
ext_idle_notifier_v12Idle-timeout notifications
zwp_idle_inhibit_manager_v11Idle inhibition

XWayland​

Built when XWayland dependencies are available, then started on demand for the first X11 client. xwayland_shell_v1 version 1 supports XWayland integration. Disable XWayland with meson setup build -Dxwayland=disabled.