wayrs

A simple Rust implementation of Wayland client library.

Design decisions

• Single event queue
• No interior mutability
• No libwayland compatibility
• Support blocking, non-blocking and async IO

Project status

• The main crate, wayrs-client, is feature complete and stable.

Project structure

The project is split into multiple crates:

• wayrs-client: The main crate which implements Wayland wire protocol. Provides Connection type which represents open Wayland socket, manages objects and handles callbacks.
• wayrs-protocols: A collection of Wayland protocols to use with wayrs-client.
• wayrs-utils: A collection of utils and abstractions for wayrs-client. Includes a shared memory allocator and more.
• wayrs-egl: Brings OpenGL(-ES) to wayrs. Based on EGL_KHR_platform_gbm.
• wayrs-scanner: Implements the wayrs_client:::generate! macro that generates glue code from .xml files. Generated code for the core protocol is already included in wayrs-client::protocol. Do not use this crate directly.
• wayrs-proto-parser: Parses wayland .xml files. Used by wayrs-scanner.
• wayrs-core: The core types, marshalling and unmarshalling implementation. Can be used by clients and servers.

Projects using wayrs

The following projects use wayrs and may serve as additional usage examples:

• i3bar-river: Port of i3bar for river.
• i3status-rs: Feature-rich and resource-friendly replacement for i3status.
• river-kbd-layout-watcher: Prints current keyboard layout whenever it changes.
• wayidle: Waits until the compositor reports being N seconds idle.
• wl-gammarelay-rs: Provides DBus interface to control display temperature and brightness without flickering.
• wlr-which-key: Keymap manager for wlroots-based compositors.

MSRV

1.72