2019-05-12 21:44:41 +01:00
# labwc
2020-09-01 19:45:36 +01:00
- [1. What is this? ](#1-what-is-this )
- [2. Build ](#2-build )
2021-03-07 21:25:04 +02:00
- [3. Install ](#3-install )
- [4. Configure ](#4-configure )
- [5. Run ](#5-run )
- [6. Integrate ](#6-integrate )
- [7. Roadmap ](#7-roadmap )
- [8. Scope ](#8-scope )
2020-09-01 19:45:36 +01:00
## 1. What is this?
2021-03-06 11:45:45 +00:00
Labwc is a wlroots-based stacking compositor for Wayland.
2020-11-01 22:21:24 +00:00
It has the following aims:
2020-07-07 21:45:44 +01:00
- Be light-weight, small and fast
2020-11-23 21:22:47 +00:00
- Have the look and feel of [openbox ](https://github.com/danakj/openbox ) albeit
2021-02-17 20:38:16 +00:00
with a smaller feature set
2020-11-23 21:22:47 +00:00
- Where practicable, use clients to show wall-paper, take screenshots, and so on
- Stay in keeping with wlroots and sway in terms of approach and coding style
2019-05-12 21:44:41 +01:00
2021-02-26 19:18:52 +00:00
[Video (3:42) showing features ](https://youtu.be/rE1bQjSVJzg )
2020-07-08 16:57:41 +01:00
2020-10-12 16:27:35 +01:00
2020-07-08 16:57:41 +01:00
2021-02-26 19:18:52 +00:00
2020-09-01 19:45:36 +01:00
## 2. Build
2019-05-12 21:44:41 +01:00
2021-03-06 11:45:45 +00:00
meson build/
ninja -C build/
2020-05-30 21:28:17 +01:00
2020-11-01 22:21:24 +00:00
Dependencies include:
2020-08-17 21:26:03 +01:00
2021-02-19 23:33:21 +00:00
- meson, ninja, gcc/clang
2021-01-09 22:51:20 +00:00
- wlroots (0.11.0 - 0.12.0)
2020-12-21 18:51:31 +00:00
- wayland (>=1.16)
- wayland-protocols
- libinput (>=1.14)
2020-08-17 21:26:03 +01:00
- libxml2
2020-11-01 22:21:24 +00:00
- cairo, pango, glib-2.0
2020-10-07 21:40:53 +01:00
- xkbcommon
2021-02-19 23:33:21 +00:00
- xwayland, xcb (optional)
2020-10-07 21:40:53 +01:00
2020-12-30 10:29:21 +00:00
Disable xwayland with `meson -Dxwayland=disabled build`
2020-10-07 21:40:53 +01:00
For further details see [wiki/Build ](https://github.com/johanmalm/labwc/wiki/Build ).
2020-09-01 19:45:36 +01:00
2021-03-07 21:25:04 +02:00
## 3. Install
[Fedora ](https://src.fedoraproject.org/rpms/labwc ):
sudo dnf install labwc
## 4. Configure
2020-09-01 19:45:36 +01:00
2021-02-17 21:08:38 +00:00
If you want to override the defaults, create the following files:
2020-09-03 21:06:08 +01:00
2021-02-17 21:08:38 +00:00
- ~/.config/labwc/[rc.xml ](docs/rc.xml )
- ~/.config/labwc/[menu.xml ](docs/menu.xml )
2021-02-17 21:10:37 +00:00
- ~/.local/share/themes/\<theme-name\>/openbox-3/[themerc ](docs/themerc )
2020-09-01 19:45:36 +01:00
2020-09-03 21:06:08 +01:00
See full details in the following:
2020-09-01 19:45:36 +01:00
2021-03-06 11:45:45 +00:00
- [labwc(1) ](docs/labwc.1.scd )
- [labwc-config(5) ](docs/labwc-config.5.scd )
- [labwc-theme(5) ](docs/labwc-theme.5.scd )
- [labwc-actions(5) ](docs/labwc-actions.5.scd )
2020-09-01 19:45:36 +01:00
2021-03-07 21:25:04 +02:00
## 5. Run
2020-09-01 19:45:36 +01:00
2021-03-06 11:45:45 +00:00
./build/labwc [-s < command > ]
2021-02-17 20:38:16 +00:00
Click on the background to launch a menu.
2020-09-01 19:45:36 +01:00
2020-09-11 21:01:47 +01:00
If you have not created an rc.xml configuration file, default keybinds will be:
- Alt-tab: cycle window
2021-03-01 18:41:01 +00:00
- Alt-F3: launch bemenu
2020-09-11 21:01:47 +01:00
- Alt-escape: exit
2021-03-07 21:25:04 +02:00
## 6. Integrate
2020-09-01 19:45:36 +01:00
Suggested apps to use with labwc:
2020-10-28 21:06:30 +00:00
- [grim ](https://github.com/emersion/grim ) - Screenshoter
- [wf-recorder ](https://github.com/ammen99/wf-recorder ) - Screen-recorder
- [swaybg ](https://github.com/swaywm/swaybg ) - Background image
2020-09-30 17:18:20 +01:00
- [waybar ](https://github.com/Alexays/Waybar ) - Panel
2020-10-28 21:06:30 +00:00
- [bemenu ](https://github.com/Cloudef/bemenu ) - Launcher
- [fuzzel ](https://codeberg.org/dnkl/fuzzel ) - Launcher
- [wofi ](https://hg.sr.ht/~scoopta/wofi ) - Launcher
2020-09-01 19:45:36 +01:00
2021-03-07 21:25:04 +02:00
## 7. Roadmap
2020-05-18 21:01:01 +01:00
2021-02-17 21:08:38 +00:00
The following list indicates the intended high level roadmap:
2020-11-01 22:21:24 +00:00
2020-12-30 10:29:21 +00:00
- [x] Optionally support xwayland
2020-11-01 22:21:24 +00:00
- [x] Parse openbox config files (rc.xml, autostart, environment)
2020-12-23 18:38:49 +00:00
- [x] Parse openbox themes files and associated xbm icons
2021-03-01 18:41:01 +00:00
- [x] Support maximize, iconify, close buttons
2020-10-08 20:50:20 +01:00
- [x] Catch SIGHUP to re-load config file and theme
2021-03-01 18:41:01 +00:00
- [ ] Support layer-shell protocol
- [x] Support layer-shell applications
- [ ] Support 'exclusive' zone
2021-01-09 22:51:20 +00:00
- [x] Support damage tracking to reduce CPU usage
2021-03-01 18:41:01 +00:00
- [ ] Support menus
- [x] Parse menu.xml and generate root-menu
- [ ] Separators and titles
- [ ] Submenus
- [ ] Pipe-menus
- [ ] Client menus
2020-11-01 22:21:24 +00:00
- [ ] Support wlr-output-management protocol and [kanshi ](https://github.com/emersion/kanshi.git )
2020-09-21 19:51:16 +01:00
- [ ] Support foreign-toplevel protocol (e.g. to integrate with wlroots panels/bars)
2020-11-01 22:21:24 +00:00
- [ ] Support on-screen display (osd), for example to support alt-tab window list
- [ ] Support HiDPI
2020-12-30 10:29:21 +00:00
- [ ] Support libinput configuration (tap is enabled for the time being)
2020-05-18 21:01:01 +01:00
2021-03-07 21:25:04 +02:00
## 8. Scope
2020-11-01 22:21:24 +00:00
In order to keep the code base clean and maintainable, simplicy is favoured over full specification adherence.
2021-03-01 18:41:01 +00:00
The exact acceptance criteria have not yet been defined, but the following wiki pages give an indication of the intended scope definition against the openbox specification.
2020-12-21 18:51:31 +00:00
- [configuration ](https://github.com/johanmalm/labwc/wiki/Scope-configuration )
2021-03-01 18:41:01 +00:00
- [theme ](https://github.com/johanmalm/labwc/wiki/Scope-theme-specification )
2020-12-21 18:51:31 +00:00
- [actions ](https://github.com/johanmalm/labwc/wiki/Scope-actions )
2020-11-23 22:14:32 +00:00
2021-03-01 18:41:01 +00:00
The following items are likely to be out-of-scope:
2020-09-21 19:51:16 +01:00
2020-11-01 22:21:24 +00:00
- Icons (except window buttons)
- Animations
- Gradients on window decorations and menus
- Any theme option (probably at least half of them) not required to reasonably render common themes
- Any configuration option not required to provide a simple openbox-like experience
2020-09-21 19:51:16 +01:00
