noctalia-dev/umbriel

项目介绍

Umbriel 是一个面向日常桌面使用的 Wayland 合成器，而不是最小化的参考实现。它按工作区提供 scrolling、dwindle、master 和 stacking 布局，支持标签组、scratchpad、每个输出独立工作区、窗口规则与图层规则、可选标题栏、动画概览，以及鼠标驱动的缩放与重排。视觉方面有模糊、阴影、圆角、双边框、动画和 GLSL 特效预设。显示与游戏方面包括按需开启的 HDR、可变刷新率、tearing、direct scanout 和显式同步，前提是硬件与客户端支持。输入覆盖键盘、触摸板手势、触摸、数位板、输入法，以及指针锁定与限制。集成方面支持按需 Xwayland、沙箱连接、layer shell、会话锁定，并通过 xdg-desktop-portal-umbriel 实现屏幕共享。

技术上使用 C++23，基于 wlroots 构建，场景图与渲染器 umbrielfx 是 SceneFX 的仓内硬分叉。它可以独立运行，也可以搭配 Noctalia 获得完整的桌面 shell。README 将其定位为兼顾生产力与游戏的同一套桌面：用灵活布局和标签组整理工作，同时用 HDR、VRR 和可配置的全屏呈现服务游戏 项目动机。

快速使用

1. 按 安装指南 选择发行版软件包、Nix 或源码构建完成安装。
2. 启动会话：在显示管理器中选择 Umbriel，或在 TTY 中运行 start-umbriel。
3. 确认基本可用：默认 mod+Return 打开 kitty，单独按 mod 打开 Noctalia 启动器 默认快捷键。
4. 配置：将 examples/config.toml 复制到 ~/.config/umbriel/config.toml。配置为 TOML，支持 include 和诊断信息，修改后即时生效 配置说明。
5. 完整选项参考见 在线文档。

README 未列出依赖包和各发行版的具体包名，这些信息以安装指南为准。

使用约束

项目自述处于年轻且快速演进阶段：配置键、快捷键和行为可能随版本变化，仍存在粗糙之处，当前的默认值是作者偏好而非稳定性承诺 README。HDR、可变刷新率、tearing、direct scanout 和显式同步均为按需开启，且依赖硬件与客户端支持；屏幕共享需要单独安装 xdg-desktop-portal-umbriel。许可证为 MIT LICENSE。

HotRepo 点评

在 2026-11-01 的 C++ 日榜记录中，Umbriel 为 1,354 Star、103 Fork，当日新增 29 Star，在该语言榜上最高排到第 12 名。目前只有这一条快照，只能说明单日情况，不能据此判断增长趋势：仓库很新，首次出现已进入 C++ 日榜前列。更有参考价值的是它的定位——把平铺布局、较重视觉效果与面向游戏的显示特性放在同一个合成器里，而这一细分领域通常要求用户在两者之间取舍。对已经习惯配置文件驱动工作流的 Wayland 桌面用户来说，这个组合比单日名次更值得关注。