How noctalia-dev/umbriel works
Umbriel is a Wayland compositor. Its principal workflow is to start a compositor backend, accept client and input events, manage windows in per-output workspaces and layouts, then present the resulting scene on configured outputs. The graph also covers documented configuration, effects, IPC, overview, locking, and Xwayland capabilities. Some links reflect documented capabilities or source-index imports rather than inspected call sites; unsampled implementation details are not asserted.
Main entry points: server.cpp Compositor server · workspace.cpp Workspace manager · cursor.cpp Pointer and cursor · main.cpp CLI and startup
Components 22
Compositor runtime
- CLI and startup
src/main.cpp - Compositor server
src/server/server.cpp - Backend manager
src/server/backend_manager.cpp - Xwayland support
src/xwayland/xwayland.cpp - Session lock
src/lock/session_lock.cpp
Windows and workspaces
- Workspace manager
src/workspace/workspace.cpp - Window views
src/view/view.h - Window layouts
src/layout/layout.h - Scratchpads
src/workspace/scratchpad.cpp
Input and interaction
- Pointer and cursor
src/input/cursor.cpp - Input seat
src/input/seat.h - Workspace overview
src/overview/overview.cpp
Display and effects
- Output management
src/output/output.cpp - Effect registry
src/scene/effect_registry.cpp - Scene renderer
umbrielfx/render/fx_renderer/fx_pass.c
Configuration and control
- Configuration
src/config/config.h - Config resolution
src/config/resolve.cpp - IPC commands
src/server/ipc_commands.cpp - IPC client
src/cli/ipc_client.cpp
Other components
- Desktop user
- Wayland clients
- wlroots
Connections 22
- Desktop user → CLI and startup: starts session
- CLI and startup → Compositor server: starts server
src/main.cpp - Compositor server → Backend manager: selects backend
src/server/backend_manager.cpp - Compositor server → Configuration: loads configuration
src/server/server.cpp - Compositor server → Config resolution: resolves settings
src/server/server.cpp - Wayland clients → Compositor server: connect
- Compositor server → wlroots: uses compositor APIs
- Compositor server → IPC commands: provides IPC
- Desktop user → IPC client: runs commands
- IPC client → IPC commands: sends commands
src/cli/ipc_client.cpp - Compositor server → Pointer and cursor: handles input
src/server/server.cpp - Pointer and cursor → Input seat: uses seat
src/input/cursor.cpp - Pointer and cursor → Workspace overview: routes interaction
src/input/cursor.cpp - Workspace manager → Window layouts: uses layouts
src/workspace/workspace.cpp - Workspace manager → Window views: manages windows
src/workspace/workspace.cpp - Workspace manager → Output management: associates outputs
src/workspace/workspace.cpp - Desktop user → Scratchpads: summons groups
- Compositor server → Session lock: supports locking
src/lock/session_lock.cpp - Compositor server → Xwayland support: supports X11 clients
- Output management → Effect registry: applies effects
- Effect registry → Scene renderer: selects scene effects
- Scene renderer → wlroots: extends scene rendering