LabWC: Difference between revisions

From Alpine Linux
(rearranged headings and added Include:Desktop prerequisites)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
[https://labwc.github.io LabWC] is a stacking [[Wayland]] compositor. LabWC can serve as a drop-in replacement for the [[Openbox]] window manager.
[https://labwc.github.io LabWC] is a stacking [[Wayland]] compositor. LabWC can serve as a drop-in replacement for the [[Openbox]] window manager.


== Installation ==
== Prerequisites ==
{{:Include:Desktop prerequisites}}
{{:Include:Desktop prerequisites}}
* Wayland compositors need raw access to input and output devices, typically mediated by a [[seat manager]]. Either [[seatd]] or [[elogind]] work fine, but installing both leads to conflicts.
* Setting up [[Alpine_setup_scripts#setup-wayland-base|Wayland-base]] enables [[elogind]] as [[Seat manager|seat manager]], enables [[Repositories#Community|community repository]] and enables [[eudev]].


The <Code>setup-wayland-base</Code> script installs and enables [[elogind]] as [[Seat manager|seat manager]], enables [[Repositories#Community|community repository]] and enables [[eudev]] automatically as these are required for Wayland to work.
== Installation ==


=== Set up eudev ===
Install labwc:
{{:Include:Setup Device Manager}}
 
=== Setup up a seat manager ===
 
Wayland compositors need raw access to input and output devices. This is mediated by a [[seat manager]].
 
Configure either [[seatd]] or [[elogind]] as both are supported. However using both may lead to conflicts.
 
=== Install fonts ===
 
Install DejaVu fonts, which has good Unicode coverage:
{{cmd|# apk add font-dejavu}} 
 
=== Install labwc ===
We can now install labwc:
{{Cmd|&#35; apk add labwc labwc-doc
{{Cmd|&#35; apk add labwc labwc-doc
&#35; apk add                \ # Install optional dependencies:
&#35; apk add                \ # Install optional dependencies:
Line 30: Line 17:
     swaybg              \ # wallpaper daemon
     swaybg              \ # wallpaper daemon
     swayidle            \ # idle management (DPMS) daemon
     swayidle            \ # idle management (DPMS) daemon
     dbus-x11
     dbus-x11             \
    font-dejavu           
}}
}}


Line 60: Line 48:
== See also ==
== See also ==


[https://labwc.github.io LabWC Official website]
* [https://labwc.github.io LabWC Official website]
 


[[Category:Desktop]]
[[Category:Wayland]]
[[Category:compositor]]
[[Category:compositor]]

Latest revision as of 15:26, 25 May 2025

LabWC is a stacking Wayland compositor. LabWC can serve as a drop-in replacement for the Openbox window manager.

Prerequisites

Installation

Install labwc:

# apk add labwc labwc-doc # apk add \ # Install optional dependencies: xwayland \ # recommended for compatibility reasons foot \ # default terminal emulator rofi \ # default application launcher (dmenu could be used instead) swaylock \ # lockscreen tool swaybg \ # wallpaper daemon swayidle \ # idle management (DPMS) daemon dbus-x11 \ font-dejavu

Running LabWC

To run labwc from console:

$ dbus-launch labwc

dbus-launch labwc is used because pipewire needs it, it is included in dbus-x11 and you may omit it.

(if you run labwc with seatd-launch, you will need to use $ dbus-launch seatd-launch labwc)

You can also create a simple alias in your shell rc file (e.g. .zshrc), like:

alias labwcinit="dbus-launch seatd-launch labwc"

Note:

swaylock needs to be able to read your /etc/shadow file to be able to validate your password

Configuration

LabWC aims to implement the openbox 3.4 specification, so many things working in OpenBox should be compatible.

Moreover, the project provides examples for all the configuration files and some themes, explaining where it must be located each one of them.

For additional information, labwc manpages and wiki can be consulted.

Troubleshooting

See also