#wayland #client

wayrs-utils

A collection of utils and abstractions for wayrs-client

21 releases (12 breaking)

new 0.13.0 Dec 9, 2023
0.12.0 Nov 11, 2023
0.11.0 Oct 11, 2023
0.8.0 Jul 24, 2023
0.4.0-beta.1 Mar 25, 2023

#185 in Hardware support

Download history 76/week @ 2023-08-19 117/week @ 2023-08-26 74/week @ 2023-09-02 55/week @ 2023-09-09 77/week @ 2023-09-16 30/week @ 2023-09-23 53/week @ 2023-09-30 82/week @ 2023-10-07 55/week @ 2023-10-14 50/week @ 2023-10-21 48/week @ 2023-10-28 46/week @ 2023-11-04 116/week @ 2023-11-11 75/week @ 2023-11-18 136/week @ 2023-11-25 64/week @ 2023-12-02

397 downloads per month
Used in 4 crates

MIT license

145KB
2.5K SLoC

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 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.
  • wayrs-scanner: Provides generate! macro that generates glue code from .xml files. Generated code for the core protocol is already included in wayrs-client. Reexported as wayrs_client::scanner.
  • 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.

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.67

Dependencies

~6MB
~117K SLoC