A modular Wayland compositor library
Find a file
Kenny Levinsen e5552055e9 wlr_compositor: Apply state before updating surface_damage
When locking surface state, surface_cache_pending will move the pending
surface state to a new, empty `wlr_surface_state`. This new surface
state will only contain the fields committed in the pending state, as
surface_state_move does not copy anything else.

surface_update_damage is called before we move state from pending to
current to merge buffer damage and surface damage, and it expects that
the pending surface state still contains prior committed details such as
scale and transform. This is not the case when we finally commit the
cached surface state.

Move surface_update_damage after surface_state_move and make it operate
purely on the current surface state.
2026-03-28 15:10:40 +01:00
.builds ci: Run tests and benchmarks 2026-03-09 22:09:40 +00:00
.gitlab/issue_templates Add GitLab issue template 2023-10-08 11:29:13 +00:00
backend output/drm: don't use OUT_FENCE_PTR 2026-03-17 18:14:35 +00:00
docs render: add WLR_RENDERER_FORCE_SOFTWARE env var 2024-12-22 21:37:57 +00:00
examples fullscreen-shell: remove 2025-03-30 01:15:09 +03:00
include render/drm_syncobj: fix flags docs for wlr_drm_syncobj_timeline_waiter_init() 2026-03-27 18:02:46 +00:00
protocol wlr-export-dmabuf-unstable-v1: fix typo 2026-03-12 11:03:57 +00:00
render render/drm_syncobj: use drmSyncobjEventfd() 2026-03-27 18:09:07 +00:00
subprojects build: add Meson wrap manifests for our dependencies 2024-12-22 21:24:03 +00:00
test tests: Initial test and benchmark setup 2026-03-09 22:09:40 +00:00
tinywl tinywl: bump wlroots version to 0.21 2026-03-19 20:23:35 +01:00
types wlr_compositor: Apply state before updating surface_damage 2026-03-28 15:10:40 +01:00
util util/box: Add wlr_box_intersects 2026-03-09 22:09:40 +00:00
xcursor xcursor: introduce wlr_xcursor_image_get_buffer() 2026-01-05 10:10:32 -05:00
xwayland treewide: make type-check helpers take const pointers 2026-03-06 16:04:21 +08:00
.editorconfig editorconfig: Unset maximum line length for .git 2024-05-25 07:54:58 +00:00
.gitignore git: fix incorrect subprojects ignore in .gitignore 2025-03-23 13:24:15 +01:00
.gitlab-ci.yml ci: update dalligi upstream repo 2026-03-06 09:37:31 -05:00
.mailmap .mailmap: add myself 2024-08-05 19:32:24 +03:00
CONTRIBUTING.md CONTRIBUTING.md: update git host 2026-02-20 00:31:06 +01:00
LICENSE license: add copyright line for all contributors 2023-07-05 10:27:50 +02:00
meson.build build: bump version to 0.21.0-dev 2026-03-19 20:14:53 +01:00
meson.options tests: Initial test and benchmark setup 2026-03-09 22:09:40 +00:00
README.md backend/drm: use libdisplay-info to parse EDID 2023-02-28 14:44:02 +00:00
release.sh Add release script 2025-09-22 10:12:43 -04:00
wlroots.syms build: simplify version script 2021-06-17 11:03:21 +02:00

wlroots

Pluggable, composable, unopinionated modules for building a Wayland compositor; or about 60,000 lines of code you were going to write anyway.

  • wlroots provides backends that abstract the underlying display and input hardware, including KMS/DRM, libinput, Wayland, X11, and headless backends, plus any custom backends you choose to write, which can all be created or destroyed at runtime and used in concert with each other.
  • wlroots provides unopinionated, mostly standalone implementations of many Wayland interfaces, both from wayland.xml and various protocol extensions. We also promote the standardization of portable extensions across many compositors.
  • wlroots provides several powerful, standalone, and optional tools that implement components common to many compositors, such as the arrangement of outputs in physical space.
  • wlroots provides an Xwayland abstraction that allows you to have excellent Xwayland support without worrying about writing your own X11 window manager on top of writing your compositor.
  • wlroots provides a renderer abstraction that simple compositors can use to avoid writing GL code directly, but which steps out of the way when your needs demand custom rendering code.

wlroots implements a huge variety of Wayland compositor features and implements them right, so you can focus on the features that make your compositor unique. By using wlroots, you get high performance, excellent hardware compatibility, broad support for many wayland interfaces, and comfortable development tools - or any subset of these features you like, because all of them work independently of one another and freely compose with anything you want to implement yourself.

Check out our wiki to get started with wlroots. Join our IRC channel: #wlroots on Libera Chat.

A variety of wrapper libraries are available for using it with your favorite programming language.

Building

Install dependencies:

  • meson
  • wayland
  • wayland-protocols
  • EGL and GLESv2 (optional, for the GLES2 renderer)
  • Vulkan loader, headers and glslang (optional, for the Vulkan renderer)
  • libdrm
  • GBM (optional, for the GBM allocator)
  • libinput (optional, for the libinput backend)
  • xkbcommon
  • udev (optional, for the session)
  • pixman
  • libseat (optional, for the session)
  • hwdata (optional, for the DRM backend)
  • libdisplay-info (optional, for the DRM backend)
  • libliftoff (optional, for the DRM backend)

If you choose to enable X11 support:

  • xwayland (build-time only, optional at runtime)
  • libxcb
  • libxcb-render-util
  • libxcb-wm
  • libxcb-errors (optional, for improved error reporting)

Run these commands:

meson setup build/
ninja -C build/

Install like so:

sudo ninja -C build/ install

Contributing

See CONTRIBUTING.md.