Skip to content

Getting started

Wayle is a Wayland desktop shell written in Rust with GTK4 and Relm4. It provides a top bar, notification center, on-screen display, wallpaper management and much more. Built-in mechanisms to handle audio, Bluetooth, network, media, battery and power controls.

Settings can be edited in config.toml, through the wayle-settings GUI, or with the wayle config CLI. All three surfaces provided hot reloaded updates, reflected in the shell immediately.

Wayle requires a Wayland compositor that implements the wlr-layer-shell protocol.

Install

Other distros

You'll need these libraries plus their -dev / -devel headers:

LibraryMinimum version
GTK4.12
gtk4-layer-shell1.0
GtkSourceView5
libpulse8
fftw33
libpipewire0.3
libudevany

Plus a C toolchain: clang, cmake, pkg-config, git, and a C/C++ compiler.

Released under the MIT License.