mirror of
https://github.com/labwc/labwc.git
synced 2026-02-08 10:06:59 -05:00
A Wayland window-stacking compositor
https://labwc.github.io
It is better to be explicit with config files and only using those specifically intended for labwc. Whilst compatibility with openbox is intended, there are areas where it just doesn't make sense to include settings intended for openbox, for example in the case of $HOME/.config/openbox/autostart With built-in icons and theme/config settings, it should be easy for new users to get started without spending time on config files anyway. |
||
|---|---|---|
| data | ||
| docs | ||
| include | ||
| protocols | ||
| src | ||
| tests | ||
| tools | ||
| .clang-format | ||
| .gitignore | ||
| LICENSE | ||
| meson.build | ||
| README.md | ||
labwc
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.
Table of Contents
Dependencies
Runtime dependencies include:
- wlroots (>=0.10.0)
- xwayland
- libxml2
- cairo
- pango
Roadmap
- Support xwayland
- Parse rc.xml
- Parse themerc
- Read xbm icons
- Show maximize, minimize, close buttons
- Give actions to maximize, minimize, close buttons
- Add grip
- Support layer-shell background (e.g. using swaybg)
- Draw better alt-tab rectangle
- Try restarting and consider catching SIGHUP for --reconfigure
- Implement client-menu
- Implement root-menu
For further details see wiki/Roadmap.
Inspiration
Labwc has been inspired and inflenced by openbox, sway, cage, wio and rootston
Design
Labwc is based on the wlroots library.
The following were considered before choosing wlroots: qtwayland, grefsen, mir and egmde.
Configuration
See rc.xml and themerc comments for details including keybinds.
Full details in labwc(1) and labwc(5)
Suggest either copying data/rc.xml to ~/.config/labwc/running, or running with:
./build/labwc -c data/rc.xml
Integration
Suggested apps:
- grim - screenshots
Build
meson build && ninja -C build
For further details see tools/build and wiki/Build.
