smithay/README.md

47 lines
2.2 KiB
Markdown
Raw Normal View History

2017-01-20 09:09:38 +00:00
# Smithay
2017-10-04 09:30:07 +00:00
[![Crates.io](http://meritbadge.herokuapp.com/smithay)](https://crates.io/crates/smithay)
[![docs.rs](https://docs.rs/smithay/badge.svg)](https://docs.rs/smithay)
2020-04-12 07:13:28 +00:00
[![Build Status](https://github.com/Smithay/smithay/workflows/Continuous%20Integration/badge.svg)](https://github.com/Smithay/smithay/actions)
2017-10-04 09:30:07 +00:00
[![Join the chat on matrix at @smithay:matrix.org](matrix_badge.svg)](https://matrix.to/#/#smithay:matrix.org)
2018-05-13 13:01:50 +00:00
[![Join the chat via bridge on gitter at smithay/Lobby ](https://badges.gitter.im/smithay/Lobby.svg)](https://gitter.im/smithay/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
2017-02-22 22:11:14 +00:00
2017-01-20 09:09:38 +00:00
A smithy for rusty wayland compositors
## Goals
Smithay aims to provide building blocks to create wayland compositors in Rust. While not
being a full-blown compositor, it'll provide objects and interfaces implementing common
functionalities that pretty much any compositor will need, in a generic fashion.
2017-01-20 09:09:38 +00:00
Also:
2018-05-13 13:01:50 +00:00
- **Documented:** Smithay strives to maintain a clear and detailed documentation of its API and its
functionalities. Compiled documentations are available on [docs.rs](https://docs.rs/smithay) for released
2018-05-13 13:01:50 +00:00
versions, and [here](https://smithay.github.io/smithay) for the master branch.
2017-01-20 09:09:38 +00:00
- **Safety:** Smithay will target to be safe to use, because Rust.
- **Modularity:** Smithay is not a framework, and will not be constraining. If there is a
part you don't want to use, you should not be forced to use it.
- **High-level:** You should be able to not have to worry about gory low-level stuff (but
Smithay won't stop you if you really want to dive into it).
2018-05-13 13:01:50 +00:00
## Anvil
Like others, Smithay as a compositor library has its own sample compositor: anvil.
You can run it with cargo after having cloned this repository:
```
cd anvil;
cargo run -- --{backend}
2018-05-13 13:01:50 +00:00
```
The currently available backends are:
- `--winit`: start anvil as a [Winit](https://github.com/tomaka/winit) application. This allows you to run it
inside of an other X11 or Wayland session.
- `--tty-udev`: start anvil in a tty with udev support. This is the "traditional" launch of a Wayland
compositor. Note that this requires you to start anvil as root if your system does not have logind
available.