1[![crates.io](https://meritbadge.herokuapp.com/smithay-client-toolkit)](https://crates.io/crates/smithay-client-toolkit)
2[![docs.rs](https://docs.rs/smithay-client-toolkit/badge.svg)](https://docs.rs/smithay-client-toolkit)
3[![Build Status](https://github.com/Smithay/client-toolkit/workflows/Continuous%20Integration/badge.svg)](https://github.com/Smithay/client-toolkit/actions?query=workflow%3A%22Continuous+Integration%22)
4
5# Smithay's Client Toolkit
6
7This crate is a toolkit for writing wayland clients in rust, on top of [wayland-client](https://crates.io/crates/wayland-client).
8
9Currently a work in progress, it currently provides the following utilities:
10
11- Automatic binding of general wayland globals (`wl_compositor`, `wl_shm`, etc..)
12- Abstraction to create windows (aka toplevel surfaces), abstracting the interaction
13  with the shell (`xdg_shell` or `wl_shell`) and the drawing of decorations
14- Wrapper for `wl_keyboard` for automatic keymap interpretation using `libxkbcommon.so`.
15- Utilites for creating dpi aware surfaces.
16
17## Documentation
18
19The documentation for the master branch is [available online](https://smithay.github.io/client-toolkit/).
20
21The documentation for the releases can be found on [docs.rs](https://docs.rs/smithay-client-toolkit).
22
23## Requirements
24
25Requires at least rust 1.41 to be used and version 1.12 of the wayland system
26libraries.
27