8 stable releases
new 3.0.0 | Dec 10, 2024 |
---|---|
2.0.4 | Nov 17, 2024 |
2.0.3 | Jul 15, 2024 |
2.0.2 | Jun 18, 2024 |
1.0.1 | Jan 9, 2024 |
#829 in GUI
2,945 downloads per month
Used in 12 crates
(via wayrs-scanner)
19KB
379 lines
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. ProvidesConnection
type which represents open Wayland socket, manages objects and handles callbacks.wayrs-protocols
: A collection of Wayland protocols to use withwayrs-client
.wayrs-utils
: A collection of utils and abstractions forwayrs-client
. Includes a shared memory allocator and more.wayrs-egl
: Brings OpenGL(-ES) towayrs
. Based onEGL_KHR_platform_gbm
.wayrs-scanner
: Implements thewayrs_client:::generate!
macro that generates glue code from.xml
files. Generated code for the core protocol is already included inwayrs-client::protocol
. Do not use this crate directly.wayrs-proto-parser
: Parses wayland.xml
files. Used bywayrs-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
Dependencies
~1.5MB
~21K SLoC