mirrors/wlroots
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/wlroots/wlroots.git synced 2026-04-13 08:22:16 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions
A modular Wayland compositor library
7800 commits 72 branches 46 tags 30 MiB
Find a file
Simon Désaulniers af521c0703 ext-image-capture-source/output: don't lock direct scanout while capturing 
The lock_attach_render call in output_source_start() disables direct
scanout for the entire duration of an ext-image-copy-capture session.
This forces the compositor to perform composited rendering on every
frame, which causes visible stuttering in fullscreen applications
(e.g. games running via XWayland/DXVK).

Unlike wlr-screencopy, ext-image-copy-capture receives the committed
buffer via output_event_commit (event->state->buffer), which is valid
regardless of whether direct scanout is active. The render lock is
therefore unnecessary for this protocol.

When cursors are requested, lock_software_cursors already implicitly
prevents direct scanout whenever the cursor is visible, ensuring
cursors appear correctly in the captured output.

Refs: https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/3953
2026-04-11 20:59:57 -04: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 vulkan: Add support for render timer using timestamp queries 2026-04-09 15:13:49 +02:00
protocol ext_background_effect_v1: add implementation 2026-04-09 10:43:46 +00:00
render vulkan: Add support for render timer using timestamp queries 2026-04-09 15:13:49 +02: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 ext-image-capture-source/output: don't lock direct scanout while capturing 2026-04-11 20:59:57 -04: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

README.md

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.