Labwc is a wlroots-based stacking compositor for Wayland.
It aims to be light-weight and independent, with a focus on simply stacking windows well and rendering some window decorations. Where practicable, it uses clients for wall-paper, panels, screenshots, and so on.
Labwc tries to stay in keeping with wlroots and sway in terms of general approach and coding style.
In order to avoid re-inventing configuration & theme syntax, openbox-3.4 specification is used. This does not mean that labwc is an openbox clone. In fact, as a Wayland compositor it is quite different in areas, and the acceptance criteria only covers ca 40% of openbox features.
meson build/
ninja -C build/
Dependencies include:
- meson, ninja, gcc/clang
- wlroots (master)
- wayland (>=1.19)
- wayland-protocols
- libinput (>=1.14)
- libxml2
- cairo, pango, glib-2.0
- xkbcommon
- xwayland, xcb (optional)
Disable xwayland with meson -Dxwayland=disabled build/
For further details see wiki/Build.
See wiki/Install.
Labwc uses the files listed below for configuration and theming.
| file | user over-ride location | man page |
|---|---|---|
| rc.xml | ~/.config/labwc/ | labwc-config(5) |
| menu.xml | ~/.config/labwc/ | labwc-menu(5) |
| autostart | ~/.config/labwc/ | labwc(1) |
| environment | ~/.config/labwc/ | labwc-environment(5) |
| themerc | ~/.local/share/themes/<theme-name>/openbox-3/ | labwc-theme(5) |
See also labwc(1) and labwc-actions(5)
./build/labwc [-s <command>]
Click on the background to launch a menu.
If you have not created an rc.xml configuration file, default keybinds will be:
- Alt-tab: cycle window
- Alt-F3: launch bemenu
- Alt-escape: exit
Suggested apps to use with labwc:
- Screen-shooter: grim
- Screen-recorder: wf-recorder
- Background image: swaybg
- Panel: waybar
- Launchers: bemenu, fuzzel, wofi
- Output managers: kanshi, wlr-randr
A lot of emphasis is put on code simplicy when considering features.
The main development effort if focused on producing a solid foundation for a stacking compositor rather than adding configuration and theming options.
In order to define what 'small feature set' means, refer to the lists of complete and outstanding items.
For more details, see the full table of acceptance criteria.
High-level summary of progress:
- Optionally support xwayland
- Parse openbox config files (rc.xml, autostart, environment)
- Parse openbox themes files and associated xbm icons
- Support maximize, iconify, close buttons
- Catch SIGHUP to re-load config file and theme
- Support layer-shell protocol
- Support damage tracking to reduce CPU usage
- Parse menu.xml to generate a basic root-menu
- Support wlr-output-management protocol
- Support HiDPI
- Support foreign-toplevel protocol (e.g. to integrate with wlroots panels/bars)
- Support on-screen display (osd), for example to support alt-tab window list
- Support libinput configuration (tap is enabled for the time being)
High-level summary of items which are not inteded to be implemented:
- Icons (except window buttons)
- Animations
- Gradients for decoration and menus
- Any theme option not required to reasonably render common themes (it's amazing how few options are actually required).