Go to file
Tony Crisci d2c7defa10 Merge branch 'master' into output-layout-adjacent 2018-02-17 16:34:32 -05:00
backend Add missing dependencies 2018-02-14 18:42:39 +00:00
examples wayland protocol headers: use double-quote for includes 2018-02-15 07:17:02 +01:00
include Merge branch 'master' into output-layout-adjacent 2018-02-17 16:34:32 -05:00
protocol wayland protocol build: remove client protocols we do not use 2018-02-15 07:18:35 +01:00
render Log GL and EGL vendor 2018-02-15 10:40:19 +01:00
rootston xdg-shell stable: copy-pasta implementation 2018-02-14 12:52:30 +01:00
types Merge branch 'master' into output-layout-adjacent 2018-02-17 16:34:32 -05:00
util Reformat all #include directives 2018-02-12 21:29:23 +01:00
xcursor Reformat all #include directives 2018-02-12 21:29:23 +01:00
xwayland Merge pull request #629 from emersion/safe-wl-resource-get-user-data 2018-02-16 09:27:26 -05:00
.build.yml Fix CI build 2017-11-02 00:19:51 +01:00
.editorconfig Add wlr_primary_selection_device_manager and wlr_primary_selection_source 2017-12-22 19:20:12 +01:00
.gitignore Remove vim stuff from .gitignore 2018-01-26 10:06:07 -05:00
.travis.yml travis: add job building wlroots without various options 2018-01-28 16:14:38 +00:00
CONTRIBUTING.md Update CONTRIBUTING.md 2017-12-27 10:39:53 -05:00
LICENSE Initial commit 2017-04-25 11:32:52 -04:00
README.md readme: change running instructions 2017-11-16 15:59:12 -05:00
glgen.sh Change glapi.sh to generate both files 2017-11-22 14:04:29 +13:00
meson.build meson: require wayland-protocols >=1.12 for xdg-shell stable 2018-02-14 19:02:45 +01:00
meson_options.txt meson build: make enable options work as auto/true/false 2018-02-10 10:46:27 +01:00

README.md

wlroots

Pluggable, composable modules for building a Wayland compositor.

This is a WIP: status

Contributing

See CONTRIBUTING.md

Building

Install dependencies:

  • wayland
  • wayland-protocols
  • EGL
  • GLESv2
  • DRM
  • GBM
  • libinput
  • udev
  • pixman
  • systemd (optional, for logind support)
  • elogind (optional, for logind support on systems without systemd)
  • libcap (optional, for capability support)
  • asciidoc (optional, for man pages)

Run these commands:

meson build
ninja -C build

(On FreeBSD, you need to pass an extra flag to prevent a linking error: meson build -D b_lundef=false)

Running the Reference Compositor

wlroots comes with a reference compositor called rootston that demonstrates the features of the library.

After building, run rootston from a terminal or VT with:

./build/rootston/rootston

Now you can run windows in the compositor from the command line or by configuring bindings in your rootston.ini file.