noctalia-dev / umbriel

# Umbriel
Umbriel is a Wayland compositor designed for daily use, with scrolling, dwindle, and master layouts, per-output
workspaces, window rules, blur, shadows, and fluid animations.
It runs independently and can be paired with Noctalia, which provides a
first-class desktop shell experience for Umbriel. Umbriel is built in C++23 on
wlroots and `umbrielfx`, its independently maintained, in-tree hard fork
of SceneFX. Xwayland support comes from wlroots' Xwayland server, which starts on
demand and needs the `Xwayland` binary installed and on `PATH`. Portal screen capture and sharing is provided by
xdg-desktop-portal-umbriel, an
xdg-desktop-portal backend for Umbriel.
> [!IMPORTANT]
> Umbriel is young and actively evolving. It is usable today, but configuration keys, keybinds, and behavior may change
> between releases, and rough edges remain. Current defaults are opinions, not stability promises.
## Why Umbriel?
When people ask what Umbriel's selling point is, the honest answer is that there is no single killer feature. We were
simply disappointed with the choices available to us, so we built the compositor we wanted to live in. The plan is
not to conquer the world or take over the big names; it is to feel at home with something we have a say in, with less
friction. That is exactly how Noctalia came to life, and Umbriel is its compositor side.
We want one desktop for productivity and gaming: flexible layouts, tab groups, and scratchpads for organizing work,
alongside HDR, variable refresh rate, and configurable fullscreen presentation for games.
To understand the values and philosophy guiding the project, read our ethos.
## Features
- Scrolling, dwindle, and master layouts with per-workspace selection, width presets, animated navigation, and
 mouse-driven resizing and tiled reordering
- Tab groups that stack, move, and resize like any row in the scrolling layout,
 and tab whole areas in the master layout, with a clickable, scrollable, draggable tab bar that can be hidden
- Independent workspaces per output, with dynamic or named workspaces, hotplug restoration, fractional scaling, and
 configurable modes, positions, and transforms
- Floating, pinned, and fullscreen windows with configurable placement, focus, sizing, opacity, and visual effects
- Window rules and layer rules for application placement,
 focus, decorations, and effects
- Global named scratchpads for temporarily hiding
 window groups and summoning them on any output
- An animated overview, directional focus, configurable keybinds, submaps, and activation policy
- Blur, shadows, rounded corners, double borders, opacity, and animated position, size, and fade transitions
- Keyboard, pointer, touch, touchpad gestures, XKB configuration, and text-input-v3/input-method-v2 input method support
- Tablet and pad input, relative pointer motion, pointer locking, and per-window pointer confinement
- Color-managed HDR with automatic fullscreen activation, configurable SDR reference white,
 and SDR