A Wayland window-stacking compositor https://labwc.github.io
Find a file
2020-09-11 21:01:47 +01:00
data Support inactive unpressed icons 2020-08-21 20:35:06 +01:00
docs rcxml: amend default keybinds 2020-09-11 20:51:25 +01:00
include Add desktop.c 2020-09-11 20:48:28 +01:00
protocols Add meson.build 2020-05-20 22:04:22 +01:00
src rcxml: amend default keybinds 2020-09-11 20:51:25 +01:00
tests tests: avoid fontconfig ASAN warnings 2020-09-07 20:14:46 +01:00
tools mv xbm/ .. 2020-08-31 20:01:08 +01:00
.clang-format Support xwayland view resize (LAB_DECO_PART_LEFT) 2020-05-25 13:42:40 +01:00
.gitignore src/main.c: read themerc specified by rc.xml 2020-07-20 19:53:03 +01:00
LICENSE Initial commit 2019-05-11 21:21:58 +01:00
meson.build meson.build: remove werror=true 2020-08-18 20:16:05 +01:00
README.md README.md: add default keybinds 2020-09-11 21:01:47 +01:00

labwc

1. What is this?

Labwc is a [WIP] free, stacking compositor for Wayland and has the following aims:

  • Be light-weight, small and fast
  • Have the look and feel of openbox
  • Where practicable, use other software to show wall-paper, take screenshots, and so on

It is in early development, so expect bugs and missing features.

Labwc has been inspired and influenced by openbox, sway, cage, wio and rootston

Labwc is based on the wlroots library. The following were considered before choosing wlroots: qtwayland, grefsen, mir and egmde.

2. Build

meson build && ninja -C build

Runtime dependencies include:

  • wlroots (>=0.10.0)
  • xwayland
  • libxml2
  • cairo
  • pango

For further details see tools/build and wiki/Build.

3. Configure

If you want to override the defaults, copy data/rc.xml to ~/.config/labwc/ and tweak to suit.

See rc.xml and themerc comments for details including keybinds.

See full details in the following:

4. Run

./build/labwc -s <some-application>

If you have not created an rc.xml configuration file, default keybinds will be:

  • Alt-tab: cycle window
  • Alt-F2: cycle window
  • Alt-F3: launch dmenu (if installed)
  • Alt-escape: exit

5. Integrate

Suggested apps to use with labwc:

  • grim - Take screenshot

6. Roadmap

  • Support xwayland
  • Parse rc.xml
  • Parse themerc
  • Read xbm icons
  • Show maximize, iconify, close buttons (maximize function not supported yet)
  • Add grip
  • Support layer-shell background layer for use with swaybg
  • Catching SIGHUP for --reconfigure
  • Implement client-menu
  • Implement root-menu
  • Add OSD, for example to support alt-tab window list

For further details see wiki/Roadmap.