mirror of
https://github.com/Smithay/smithay.git
synced 2024-09-28 03:21:14 +02:00
91e61f1350
Update README.md
64 lines
3.4 KiB
Markdown
64 lines
3.4 KiB
Markdown
<img align="right" width="25%" src="https://github.com/Smithay/smithay/assets/20758186/7a84ab10-e229-4823-bad8-9c647546407b">
|
|
|
|
# Smithay
|
|
|
|
[![Crates.io](https://img.shields.io/crates/v/smithay.svg)](https://crates.io/crates/smithay)
|
|
[![docs.rs](https://docs.rs/smithay/badge.svg)](https://docs.rs/smithay)
|
|
[![Build Status](https://github.com/Smithay/smithay/workflows/Continuous%20Integration/badge.svg)](https://github.com/Smithay/smithay/actions)
|
|
[![Join the chat on matrix at #smithay:matrix.org](https://img.shields.io/badge/%5Bm%5D-%23smithay%3Amatrix.org-blue.svg)](https://matrix.to/#/#smithay:matrix.org)
|
|
![Join the chat via bridge on #smithay on libera.chat](https://img.shields.io/badge/IRC-%23Smithay-blue.svg)
|
|
|
|
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.
|
|
|
|
It supports the [core Wayland protocols](https://gitlab.freedesktop.org/wayland/wayland), the official [protocol extensions](https://gitlab.freedesktop.org/wayland/wayland-protocols), and *some* external extensions, such as those made by and for [wlroots](https://gitlab.freedesktop.org/wlroots/wlr-protocols) and [KDE](https://invent.kde.org/libraries/plasma-wayland-protocols)
|
|
<!-- https://github.com/Smithay/smithay/pull/779#discussion_r993640470 https://github.com/Smithay/smithay/issues/778 -->
|
|
|
|
Also:
|
|
|
|
- **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
|
|
versions, and [here](https://smithay.github.io/smithay) for the master branch.
|
|
- **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).
|
|
|
|
|
|
## Anvil
|
|
|
|
Smithay as a compositor library has its own sample compositor: anvil.
|
|
|
|
To get informations about it and how you can run it visit [anvil README](https://github.com/Smithay/smithay/blob/master/anvil/README.md)
|
|
|
|
## Other compositors that use Smithay
|
|
|
|
- [Cosmic](https://github.com/pop-os/cosmic-epoch): Next generation Cosmic desktop environment
|
|
- [Catacomb](https://github.com/catacombing/catacomb): A Wayland Mobile Compositor
|
|
- [MagmaWM](https://github.com/MagmaWM/MagmaWM): A versatile and customizable Wayland Compositor
|
|
- [Niri](https://github.com/YaLTeR/niri): A scrollable-tiling Wayland compositor
|
|
- [Strata](https://github.com/StrataWM/strata): A cutting-edge, robust and sleek Wayland compositor
|
|
- [Pinnacle](https://github.com/Ottatop/pinnacle): A WIP Wayland compositor, inspired by AwesomeWM
|
|
- [Sudbury](https://gitlab.freedesktop.org/bwidawsk/sudbury): Compositor designed for ChromeOS
|
|
|
|
## System Dependencies
|
|
|
|
(This list can depend of features you enable)
|
|
|
|
- `libwayland`
|
|
- `libxkbcommon`
|
|
- `libudev`
|
|
- `libinput`
|
|
- `libgbm`
|
|
- [`libseat`](https://git.sr.ht/~kennylevinsen/seatd)
|
|
- `xwayland`
|
|
|
|
## Contact us
|
|
|
|
If you have questions or want to discuss the project with us, our main chatroom is on Matrix: [`#smithay:matrix.org`](https://matrix.to/#/#smithay:matrix.org).
|