2019-05-12 21:44:41 +01:00
|
|
|
# labwc
|
|
|
|
|
|
2020-06-05 21:07:05 +01:00
|
|
|
Labwc is a free, stacking compositor for Wayland.
|
|
|
|
|
|
|
|
|
|
It is in early development and has the following aims:
|
|
|
|
|
|
|
|
|
|
- Be light-weight, small and fast.
|
|
|
|
|
- Have the look and feel of the X11 Window Manager Openbox.
|
|
|
|
|
- Where practicable, use other software to show wall-paper, take screenshots,
|
|
|
|
|
and so on.
|
2019-05-12 21:44:41 +01:00
|
|
|
|
2020-05-18 21:01:01 +01:00
|
|
|
|
2020-05-21 20:28:57 +01:00
|
|
|
## Dependencies
|
2019-05-12 21:44:41 +01:00
|
|
|
|
2020-05-12 20:37:05 +01:00
|
|
|
- wlroots (>=0.10.0)
|
2019-05-12 21:44:41 +01:00
|
|
|
- wayland-protocols
|
2020-05-21 20:28:57 +01:00
|
|
|
- xwayland
|
2020-06-08 19:49:19 +01:00
|
|
|
- libxml2
|
2019-05-12 21:44:41 +01:00
|
|
|
|
2020-05-30 21:28:17 +01:00
|
|
|
Will soon depend on
|
|
|
|
|
|
|
|
|
|
- cairo, pango, glib
|
|
|
|
|
|
2020-06-05 21:07:05 +01:00
|
|
|
## Roadmap
|
2020-05-18 21:01:01 +01:00
|
|
|
|
2020-05-22 21:13:43 +01:00
|
|
|
- [x] Support xwayland
|
|
|
|
|
- [ ] Support some of openbox's rc.xml
|
|
|
|
|
- [ ] Support openbox themes
|
|
|
|
|
- [ ] Support layer-shell's background layer
|
2020-05-18 21:01:01 +01:00
|
|
|
|
2020-05-21 20:28:57 +01:00
|
|
|
## Influenced by
|
2020-05-18 21:01:01 +01:00
|
|
|
|
|
|
|
|
- [sway](https://github.com/swaywm/sway)
|
|
|
|
|
- [cage](https://www.hjdskes.nl/blog/cage-01/)
|
|
|
|
|
- [wio](https://wio-project.org/)
|
2020-05-21 20:28:57 +01:00
|
|
|
- [rootston](https://github.com/swaywm/rootston)
|
2020-05-18 21:01:01 +01:00
|
|
|
- [openbox](https://github.com/danakj/openbox)
|
|
|
|
|
|
2020-05-21 20:28:57 +01:00
|
|
|
## Alternatives
|
2020-05-10 20:10:36 +01:00
|
|
|
|
2020-05-18 21:01:01 +01:00
|
|
|
The following were considered before choosing wlroots:
|
2020-05-10 20:10:36 +01:00
|
|
|
|
2020-05-18 21:01:01 +01:00
|
|
|
- [QtWayland](https://github.com/qt/qtwayland), [grefsen](https://github.com/ec1oud/grefsen)
|
|
|
|
|
- [Mir](https://mir-server.io), [egmde](https://github.com/AlanGriffiths/egmde)
|
2020-05-10 20:10:36 +01:00
|
|
|
|
2020-05-21 20:28:57 +01:00
|
|
|
## Configuration
|
2020-05-10 20:10:36 +01:00
|
|
|
|
2020-06-08 19:49:19 +01:00
|
|
|
See [rc.xml](data/rc.xml) comments for details, incl. keybinds.
|
2020-05-18 21:01:01 +01:00
|
|
|
|
2020-05-21 20:28:57 +01:00
|
|
|
## Integration
|
2020-05-18 21:01:01 +01:00
|
|
|
|
2020-06-08 19:49:19 +01:00
|
|
|
Suggested apps:
|
|
|
|
|
|
|
|
|
|
- grim - screenshots
|
2020-05-18 21:01:01 +01:00
|
|
|
|
2020-05-21 20:28:57 +01:00
|
|
|
## Build
|
|
|
|
|
|
|
|
|
|
### Arch Linux
|
|
|
|
|
|
|
|
|
|
sudo pacman -S wlroots
|
|
|
|
|
git clone https://github.com/johanmalm/labwc
|
|
|
|
|
cd labwc
|
|
|
|
|
meson build
|
|
|
|
|
ninja -C build
|
|
|
|
|
|
|
|
|
|
### Debian
|
|
|
|
|
|
2020-05-22 21:13:43 +01:00
|
|
|
```
|
|
|
|
|
sudo apt install \
|
|
|
|
|
build-essential \
|
|
|
|
|
cmake \
|
|
|
|
|
libwayland-dev \
|
|
|
|
|
wayland-protocols \
|
|
|
|
|
libegl1-mesa-dev \
|
|
|
|
|
libgles2-mesa-dev \
|
|
|
|
|
libdrm-dev libgbm-dev \
|
|
|
|
|
libinput-dev \
|
|
|
|
|
libxkbcommon-dev \
|
|
|
|
|
libudev-dev \
|
|
|
|
|
libpixman-1-dev \
|
|
|
|
|
libsystemd-dev \
|
|
|
|
|
libcap-dev \
|
|
|
|
|
libxcb1-dev \
|
|
|
|
|
libxcb-composite0-dev \
|
|
|
|
|
libxcb-xfixes0-dev \
|
|
|
|
|
libxcb-xinput-dev \
|
|
|
|
|
libxcb-image0-dev \
|
|
|
|
|
libxcb-render-util0-dev \
|
|
|
|
|
libx11-xcb-dev \
|
|
|
|
|
libxcb-icccm4-dev \
|
|
|
|
|
freerdp2-dev \
|
|
|
|
|
libwinpr2-dev \
|
|
|
|
|
libpng-dev \
|
|
|
|
|
libavutil-dev \
|
|
|
|
|
libavcodec-dev \
|
|
|
|
|
libavformat-dev \
|
|
|
|
|
universal-ctags \
|
|
|
|
|
xwayland
|
|
|
|
|
|
|
|
|
|
# Debian Buster has an old version of meson, so we use pip3
|
|
|
|
|
pip3 install --target=$HOME/bin meson
|
|
|
|
|
|
|
|
|
|
git clone https://github.com/johanmalm/labwc
|
|
|
|
|
cd labwc
|
|
|
|
|
git clone https://github.com/swaywm/wlroots subprojects/wlroots
|
|
|
|
|
|
|
|
|
|
# wlroots 0.10.0 is the last version which runs with Wayland 0.16
|
|
|
|
|
# (which is what Buster runs)
|
|
|
|
|
cd subprojects/wlroots && git checkout 0.10.0 && cd ../..
|
|
|
|
|
|
|
|
|
|
meson build
|
|
|
|
|
ninja -C build
|
|
|
|
|
```
|
2020-05-21 20:28:57 +01:00
|
|
|
|
|
|
|
|
## Debug
|
|
|
|
|
|
|
|
|
|
To enable ASAN and UBSAN, run meson with `-Db_sanitize=address,undefined`
|
2020-05-22 21:13:43 +01:00
|
|
|
|
