- Rust 98.6%
- Python 1.2%
- GLSL 0.2%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
20ddbd0a85
The mechanism install carries the scanner's own rule definitions; a gate cannot enter a repository it protects without its patterns appearing in that diff. The tree is exempted by manifest, the commit is reviewed here. |
||
| .gitea/workflows | ||
| .github | ||
| .publication | ||
| anvil | ||
| benches | ||
| examples | ||
| smallvil | ||
| smithay-drm-extras | ||
| src | ||
| test_clients | ||
| wlcs_anvil | ||
| .gitignore | ||
| .publication-history-allowlist.txt | ||
| .publication-mechanism.json | ||
| .rustfmt.toml | ||
| AI.md | ||
| build.rs | ||
| Cargo.toml | ||
| CHANGELOG.md | ||
| clippy.toml | ||
| compile_wlcs.sh | ||
| CONTRIBUTING.md | ||
| DCO.md | ||
| doc_index.html | ||
| GETTING_STARTED.md | ||
| LICENSE.txt | ||
| README.md | ||
| test_gbm_bo_create_with_modifiers2.c | ||
| test_gbm_bo_get_fd_for_plane.c | ||
| typos.toml | ||
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, the official protocol extensions, and some external extensions, such as those made by and for wlroots and KDE.
Also:
- Documented: Smithay strives to maintain clear and detailed documentation of its API and functionalities. Compiled documentation is available on docs.rs for released versions, and here for the master branch.
- Safety: Smithay aims to be memory-safe and reliable, thanks to Rust.
- Modularity: Smithay is not a framework and does not impose constraints. You are never required to use components you don’t need.
- High-level: You should not have to worry about gory low-level stuff (but Smithay won't stop you if you really want to dive into it).
Getting started
If you want to learn how to build a compositor with Smithay, the best place to start is the getting started guide.
Anvil
Smithay as a compositor library has its own sample compositor: anvil.
To get information about it and how you can run it, check out the anvil README
Other compositors that use Smithay
- Cosmic: Next-generation Cosmic desktop environment
- Catacomb: A Wayland Mobile Compositor
- emskin: A nested Wayland compositor for embedding any app inside Emacs
- MagmaWM: A versatile and customizable Wayland Compositor
- Niri: A scrollable-tiling Wayland compositor
- Strata: A cutting-edge, robust and sleek Wayland compositor
- Pinnacle: A WIP Wayland compositor, inspired by AwesomeWM
- Sudbury: Compositor designed for ChromeOS
- wprs: Like xpra, but for Wayland, and written in Rust.
- Local Desktop: An Android app for running GUI Linux via PRoot and Wayland.
- Otto: A gesture-driven stacking compositor.
- DriftWM: A trackpad-first infinite canvas Wayland compositor.
System Dependencies
(This list can depend on the features you enable)
libwaylandlibxkbcommonlibudevlibinputlibgbmlibseatxwayland
Contact us
If you have questions or want to discuss the project with us, our main chatroom is on Matrix: #smithay:matrix.org.
Contributing
General notes on contributing to Smithay can be found here.
Please note that to submit code to Smithay, you must agree to our Developer Certificate of Origin.
If you are used to using generative AI, please ensure you read our Policy before starting.
Why this fork exists
This is Smithay with five patches on top of upstream
812bd33259ff58810dadef6086d8385eeac1ca55 (renderer: cgmath -> glam,
2026-07-14). 332 insertions across 7 files. Nothing else differs.
wlr-layer-shell: do not validate a role the client already destroyed. A teardown race: the client destroys the role, the compositor validates it anyway, the session dies.session-lock: tolerate a bufferless commit before the first ack. A lock surface that commits before acking is legal and was rejected.gles: optional linear-space gamut transform on sampled textures. Opt-in. Needed to map sRGB content into a panel's own primaries.drm/compositor: wait when there is no native fence. Without it a device with no native fence tears.gles: optional chromatic split on sampled textures. Opt-in.
The first two are plain upstream bugs. The fence wait is a correctness fix.
The two gles changes are feature-gated and off by default. All five look
upstreamable; none has been submitted yet.
Consumed by souveraine-viewtop, which pins this fork by revision.