Alpine Linux - User contributions [en]

PipeWire

2022-10-19T01:11:57Z

Adm: /* D-Bus */

{{Draft|The instructions below have not been thoroughly tested and may break things.}}

[https://pipewire.org/ PipeWire] is a multimedia processing engine that aims to improve audio and video handling on Linux.

== Prerequisites ==

=== Audio Group ===

When elogind is not available, the user has to be added to the <code>audio</code> group. The user must re-log-in in for this to take effect.

<pre>
# addgroup <user> audio
</pre>

=== D-Bus ===

PipeWire requires a running [https://www.freedesktop.org/wiki/Software/dbus/ D-Bus] session for some of its functionality. If you use a full desktop environment this will probably be started automatically, but with minimal window managers it must be done manually.

<pre>
# apk add dbus dbus-openrc
# rc-service dbus start
# rc-update add dbus default
</pre>

Then use <code>dbus-run-session</code> whenever you start an X or Wayland session. For example:
<pre>
$ dbus-run-session -- sway
</pre>

{{Note|Alternatively, it can be used <code>dbus-launch</code> (which is included in the dbus-x11 package) to start the dbus daemon independently to the graphic server}}

For certain configurations (e.g. only audio playback and recording) D-Bus setup is not necessary.

=== XDG_RUNTIME_DIR ===

If you are not using a Desktop Manager, ensure that your <code>XDG_RUNTIME_DIR</code> is set to a user-writable location. By default for pulseaudio this is {{Path|/run/user/1000/}} or {{Path|/tmp}}. If this is not set, pipewire will create a directory in your home folder instead, called <code>~/pulse</code>, and on attempting to run Pavucontrol or pactl, you will get the following error:

<pre>
$ pactl list
Connection failure: Connection refused
pa_context_connect() failed: Connection refused
</pre>

== Installation and configuration ==

<pre>
# apk add pipewire wireplumber
</pre>

{{Note|Using [https://gitlab.freedesktop.org/pipewire/wireplumber WirePlumber] rather than the pipewire-media-session (which comes with pipewire) is [https://gitlab.freedesktop.org/pipewire/media-session/-/blob/master/README.md recommended] but not required.}}

=== Realtime scheduling ===

For realtime scheduling, it is recommended to use rtkit,

<pre>
# apk add rtkit
</pre>

and then add your user to the `rtkit` group.

Alternatively, ensure your user has the right ulimit permissions. You generally need (limits.conf format):

<pre>
@audio - memlock 256
@audio - nice -11
@audio - rtprio 88
</pre>

This allows a member of the audio group to have the right permissions for PipeWire to use realtime scheduling without rtkit.

=== ALSA ===

<pre>
# apk add pipewire-alsa
</pre>

ALSA support works out of the box if you have the pipewire-alsa package. You may need the <code>snd_seq</code> kernel module.

=== PulseAudio ===

PipeWire can run a [https://www.freedesktop.org/wiki/Software/PulseAudio/ PulseAudio] daemon which should allow all existing PulseAudio applications to be used with the PipeWire backend. You need to have <code>pipewire-pulse</code> installed.

=== JACK ===

If you will be using PipeWire for [https://jackaudio.org/ JACK] applications install the required package (pipewire-jack). Things should work with just that.

=== Video ===

Video should work out-of-the-box with v4l2 devices (e.g. a lot of webcams) and [https://gstreamer.freedesktop.org/ GStreamer] applications.

=== Bluetooth audio ===

* Enable PulseAudio support as described above
* Install bluetooth service packages: <code>bluez bluez-openrc pipewire-spa-bluez</code>
* Optional: install GUI manager for bluetooth <code>blueman</code>
* Enable and start bluetooth service: <code>rc-update add bluetooth; rc-service bluetooth start</code>
* Restart PipeWire
* Use commandline program <code>bluetoothctl</code> or GUI program <code>blueman-manager</code> to scan and pair bluetooth audio devices.
* Use pavucontrol to adjust volume and manually select high definition bluetooth codecs.

== Screen sharing on Wayland ==

You will need the right [https://github.com/flatpak/xdg-desktop-portal xdg-desktop-portal] backend for your desktop environment. Screen sharing is known to work on:
* GNOME with <code>xdg-desktop-portal-gtk</code>
* KDE Plasma with <code>xdg-desktop-portal-kde</code> and Firefox
* Sway with <code>xdg-desktop-portal-wlr</code> and Firefox, see [[Sway]] for details

== Usage ==

Start the PipeWire media server. You'll probably get quite a few errors but just ignore them for now.

<pre>
$ /usr/libexec/pipewire-launcher
</pre>

{{Note| PipeWire doesn't auto-start a session manager anymore.
In 3.14 and earlier, the PipeWire default config was edited in packaging to auto-start pipewire-media-session as the default session manager. Since we now have wireplumber available as an alternative session manager, this has been changed in favor of a launch wrapper for pipewire at /usr/libexec/pipewire-launcher. When executed, this will launch pipewire, pipewire-media-session or wireplumber, and pipewire-pulse, depending on what modules are available. If you were launching /usr/bin/pipewire and the session manager manually before, please use the new launcher wrapper instead. WirePlumber can now also be used as a proper alternative for pipewire-media-session.}}

In a different terminal window check the default output device. I don't yet know how this default can be changed for all applications, so you'd better hope it's right!

wireplumber:
<pre>
$ wpctl status
</pre>

Test sound is working using an audio file in a format supported by [http://www.mega-nerd.com/libsndfile/ libsndfile] (e.g. flac, opus, ogg, wav).

<pre>
# apk add pipewire-tools
$ pw-cat -p test.flac
</pre>

If you have a microphone test audio recording is working.

<pre>
$ pw-cat -r --list-targets
$ pw-cat -r recording.flac
(Speak for a while then stop it with Ctrl+c)
$ pw-cat -p recording.flac
</pre>

Test PulseAudio clients using a media player (most use PulseAudio) and if you use JACK test that too:

<pre>
# apk add jack-example-clients
$ jack_simple_client
</pre>

You should hear a sustained beep.

If you are happy everything is working, make PipeWire start automatically when your X or Wayland session starts. For example, you could add the <code>/usr/libexec/pipewire-launcher</code> command to <code>~/.xinitrc</code> or your window manager's config file.

== Troubleshooting ==

=== `wpctl status` shows no targets ===

First, check whether ALSA knows about your sound card:

<pre>
aplay -l
</pre>

If sound devices are found, the issue is with your pipewire configuration. Consider double-checking the instructions above.

Otherwise, your sound card may not be supported in the version of the Linux Kernel you're running. You should search online for fixes relating to your current kernel version and the codec of your sound card. You can find each of these with:

<pre>
uname -r
cat /proc/asound/card0/codec* | grep Codec
</pre>

== Quick Configuration ==

You might want to use pavucontrol to have a simple GUI app for controlling sound, outputs, etc, in which case:
<pre>
# apk add pavucontrol
</pre>

== See Also ==

* [https://gitlab.freedesktop.org/pipewire/pipewire PipeWire source repository]
* [https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/home PipeWire Wiki]
* [https://wiki.archlinux.org/index.php/PipeWire PipeWire on the ArchWiki]
* [https://wiki.gentoo.org/wiki/Pipewire PipeWire on the Gentoo Wiki]

[[Category:Desktop]]
[[Category:Multimedia]]
[[Category:Sound]]

Sway

2022-05-30T10:30:44Z

Adm: Add swaybg as wallpaper daemon to the optional dependencies

[http://swaywm.org Sway] is a tiling [[Wayland]] compositor. It's a drop-in replacement for the i3 window manager.

== Prerequisites ==

First, install & configure eudev:

<pre>
# apk add eudev
# setup-udev
</pre>

Then install graphics drivers appropriate to your system:

<pre>
# apk add mesa-dri-gallium # gallium
# apk add mesa-dri-classic # or classic
# apk add mesa-dri-nouveau # for nvidia users
</pre>

The following links contain guides for setting up the video stack.

* [[Intel Video]]
* [[Radeon Video]]

Add yourself to the input and video groups:

<pre>
# adduser $USER input
# adduser $USER video
</pre>

You have to log out and back in for this to take effect.

Install some TTF fonts:

<pre>
# apk add ttf-dejavu
</pre>

Since sway 1.6.1 (more specifically, since wlroots 0.14), you need to set up libseat backend if you wish to run sway directly (without nesting it in another wayland compositor). To do that, [[Enable Community Repository|enable the community repository]] and choose one of the following methods:

<dl>

<dt>Option 1: seatd daemon (recommended)</dt>
<dd>
<pre>
# apk add seatd
# rc-update add seatd
# rc-service seatd start
# adduser $USER seat
</pre>

If you are already logged in as a $USER, you will need to relogin.
</dd>

<dt>Option 2: seatd-launch</dt>
<dd>
<pre>
# apk add seatd-launch
</pre>

When starting sway, you will need to prefix invocation with <code>seatd-launch</code>.
Note: <code>seatd-launch</code> is a suid binary, so it might be wise to use one of the other methods from a security perspective.
</dd>

<dt>Option 3: elogind daemon</dt>
<dd>

<pre>
# apk add elogind polkit-elogind
# rc-update add elogind
# rc-service elogind start
</pre>

Using <code>elogind</code> will automatically set the necessary permissions, so you can skip adding groups like <code>seat</code> and <code>video</code>

</dd>

</dl>

== Installation ==

We can now install sway:

<pre>
# apk add sway sway-doc
# apk add \ # Install optional dependencies:
xwayland \ # recommended for compatibility reasons
foot \ # default terminal emulator
dmenu \ # default application launcher
swaylock \ # lockscreen tool
swaybg \ # wallpaper daemon
swayidle # idle management (DPMS) daemon
</pre>

== Running Sway ==

To run sway, first set XDG_RUNTIME_DIR to a suitable location (e.g. create a .run folder in your home directory and set it to ~/.run). Then run sway from the Linux console (dbus-launch is used because pipewire needs it, it is included in dbus-x11 and you may omit it):

<pre>
$ XDG_RUNTIME_DIR=~/.run dbus-launch sway
</pre>

(if you run sway with seatd-launch, you will need to use <code>$ XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch sway</code>)

You can also create a simple alias in your shell rc file (e.g. .zshrc), like:
<pre>
alias swayinit="XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch sway"
</pre>

See the [https://wiki.alpinelinux.org/wiki/Wayland Wayland] page for a permanent configuration

{{Note|
swaylock needs to be able to read your <code>/etc/shadow</code> file to be able to validate your password
}}

== Configuration and Usage ==

An example config is provided at <code>/etc/sway/config</code>. Copy it to <code>~/.config/sway/config</code> and read through it to learn the default keybindings.

You might want to have gaps between windows, in which case add:
<pre>
inner_gaps 20
outer_gaps 20
</pre>
(replace 20 with the amount of pixels you want to be used for gaps) in your sway config.

You might have two monitors, and you might want to set their position, so here's an example of how to do it:
<pre>
output eDP-1 mode 1920x1080@60Hz
output eDP-1 position 1920,0
output DP-1 position 0,0
output DP-1 mode 1920x1080@120Hz
</pre>
In this case, eDP-1 is the internal laptop monitor running at 60Hz and DP-1 is the external monitor running at 120Hz. The position of the laptop monitor is where the external monitor's width ends, so if the display is 1920 pixels wide and it is on the left, the laptop's monitor would be on the right, so it's width would start at the end of the second monitor's width, so at 1920. Replace the eDP-1 and DP-1 outputs with your own ones, and to change resolution and refresh rate, change the mode according to your parameters.

For additional information, start at <code>man 5 sway</code> and read the [https://github.com/swaywm/sway/wiki upstream FAQ].

[[Category:Desktop]]

LabWC

2022-05-30T10:30:00Z

Adm: Align rofi line in the optional dependencies installation

[https://labwc.github.io LabWC] is a stacking [[Wayland]] compositor. Although [https://github.com/labwc/labwc#1-what-is-this it wasn't intended like that], it can serve as a drop-in replacement for the [[Openbox]] window manager (the same way [[Sway]] is for [[I3wm]]).

This wiki was written starting from a fresh install using the Alpine 3.16 x86 extended .iso. The steps begin from the first reboot after running setup-alpine and performing a sys install to disk.

Many steps below were taken from the [https://wiki.alpinelinux.org/wiki/Sway wiki entry for installing Sway], as both are wlroots-based Wayland compositors. Another interesting page, because of the same reasons, is the [[River]] compositor's.

== Prerequisites ==
{{Note|These steps posted as both Sway and LabWC prerequisites could be applied to almost all wlroots-based Wayland compositors.}}

First, install & configure eudev:

<pre>
# apk add eudev
# setup-udev
</pre>

Then install graphics drivers appropriate to your system:

<pre>
# apk add mesa-dri-gallium # gallium
# apk add mesa-dri-classic # or classic
# apk add mesa-dri-nouveau # for nvidia users
</pre>

The following links contain guides for setting up the video stack.

* [[Intel Video]]
* [[Radeon Video]]

Add yourself to the input and video groups:

<pre>
# adduser $USER input
# adduser $USER video
</pre>

You have to log out and back in for this to take effect.

Install some TTF fonts:

<pre>
# apk add ttf-dejavu
</pre>

Since wlroots 0.14, you need to set up libseat backend if you wish to run labwc directly (without nesting it in another wayland compositor). To do that, [[Enable Community Repository|enable the community repository]] and choose one of the following methods:

<dl>

<dt>Option 1: seatd daemon (recommended)</dt>
<dd>
<pre>
# apk add seatd
# rc-update add seatd
# rc-service seatd start
# adduser $USER seat
</pre>

If you are already logged in as a $USER, you will need to relogin.
</dd>

<dt>Option 2: seatd-launch</dt>
<dd>
<pre>
# apk add seatd-launch
</pre>

When starting labwc, you will need to prefix invocation with <code>seatd-launch</code>.
Note: <code>seatd-launch</code> is a suid binary, so it might be wise to use one of the other methods from a security perspective.
</dd>

<dt>Option 3: elogind daemon</dt>
<dd>

<pre>
# apk add elogind polkit-elogind
# rc-update add elogind
# rc-service elogind start
</pre>

Using <code>elogind</code> will automatically set the necessary permissions, so you can skip adding groups like <code>seat</code> and <code>video</code>

</dd>

</dl>

== Installation ==

We can now install labwc:

<pre>
# 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
</pre>

Note that almost all optional dependencies are the same than Sway's. Another interesting packages are specified into the [https://github.com/labwc/labwc#6-integrate project's README], as it can be [https://labwc.github.io/integration.html#waybar waybar] (included into the Alpine's repository) as navigation bar.

== Running LabWC ==

To run labwc, first set XDG_RUNTIME_DIR to a suitable location (e.g. create a .run folder in your home directory and set it to ~/.run). Then run labwc from the Linux console (dbus-launch is used because pipewire needs it, it is included in dbus-x11 and you may omit it):

<pre>
$ XDG_RUNTIME_DIR=~/.run dbus-launch labwc
</pre>

(if you run labwc with seatd-launch, you will need to use <code>$ XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc</code>)

You can also create a simple alias in your shell rc file (e.g. .zshrc), like:
<pre>
alias labwcinit="XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc"
</pre>

See the [https://wiki.alpinelinux.org/wiki/Wayland Wayland] page for a permanent configuration (recommended).

{{Note|
swaylock needs to be able to read your <code>/etc/shadow</code> file to be able to validate your password
}}

== Configuration and Usage ==

LabWC aims to implement the [http://openbox.org/wiki/Help:Contents openbox 3.4] specification, so many things working in OpenBox should be compatible.

Moreover, the project provides [https://github.com/labwc/labwc#4-configure examples for all the configuration files] and some themes, explaining where it must be located each one of them.

For additional information, labwc [https://labwc.github.io/manual.html manpages] and [https://github.com/labwc/labwc/wiki wiki] can be consulted.

[[Category:Desktop]]

LabWC

2022-05-30T10:29:23Z

Adm: Add swaybg as wallpaper daemon to the optional dependencies

LabWC

2022-05-30T09:56:23Z

Adm: Fix openbox-3.4 specification link in Configuration and Usage

[https://labwc.github.io LabWC] is a stacking [[Wayland]] compositor. Although [https://github.com/labwc/labwc#1-what-is-this it wasn't intended like that], it can serve as a drop-in replacement for the [[Openbox]] window manager (the same way [[Sway]] is for [[I3wm]]).

This wiki was written starting from a fresh install using the Alpine 3.16 x86 extended .iso. The steps begin from the first reboot after running setup-alpine and performing a sys install to disk.

Many steps below were taken from the [https://wiki.alpinelinux.org/wiki/Sway wiki entry for installing Sway], as both are wlroots-based Wayland compositors. Another interesting page, because of the same reasons, is the [[River]] compositor's.

== Prerequisites ==
{{Note|These steps posted as both Sway and LabWC prerequisites could be applied to almost all wlroots-based Wayland compositors.}}

First, install & configure eudev:

<pre>
# apk add eudev
# setup-udev
</pre>

Then install graphics drivers appropriate to your system:

<pre>
# apk add mesa-dri-gallium # gallium
# apk add mesa-dri-classic # or classic
# apk add mesa-dri-nouveau # for nvidia users
</pre>

The following links contain guides for setting up the video stack.

* [[Intel Video]]
* [[Radeon Video]]

Add yourself to the input and video groups:

<pre>
# adduser $USER input
# adduser $USER video
</pre>

You have to log out and back in for this to take effect.

Install some TTF fonts:

<pre>
# apk add ttf-dejavu
</pre>

Since wlroots 0.14, you need to set up libseat backend if you wish to run labwc directly (without nesting it in another wayland compositor). To do that, [[Enable Community Repository|enable the community repository]] and choose one of the following methods:

<dl>

<dt>Option 1: seatd daemon (recommended)</dt>
<dd>
<pre>
# apk add seatd
# rc-update add seatd
# rc-service seatd start
# adduser $USER seat
</pre>

If you are already logged in as a $USER, you will need to relogin.
</dd>

<dt>Option 2: seatd-launch</dt>
<dd>
<pre>
# apk add seatd-launch
</pre>

When starting labwc, you will need to prefix invocation with <code>seatd-launch</code>.
Note: <code>seatd-launch</code> is a suid binary, so it might be wise to use one of the other methods from a security perspective.
</dd>

<dt>Option 3: elogind daemon</dt>
<dd>

<pre>
# apk add elogind polkit-elogind
# rc-update add elogind
# rc-service elogind start
</pre>

Using <code>elogind</code> will automatically set the necessary permissions, so you can skip adding groups like <code>seat</code> and <code>video</code>

</dd>

</dl>

== Installation ==

We can now install labwc:

<pre>
# 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
swayidle # idle management (DPMS) daemon
</pre>

Note that almost all optional dependencies are the same than Sway's. Another interesting packages are specified into the [https://github.com/labwc/labwc#6-integrate project's README], as it can be [https://labwc.github.io/integration.html#waybar waybar] (included into the Alpine's repository) as navigation bar.

== Running LabWC ==

To run labwc, first set XDG_RUNTIME_DIR to a suitable location (e.g. create a .run folder in your home directory and set it to ~/.run). Then run labwc from the Linux console (dbus-launch is used because pipewire needs it, it is included in dbus-x11 and you may omit it):

<pre>
$ XDG_RUNTIME_DIR=~/.run dbus-launch labwc
</pre>

(if you run labwc with seatd-launch, you will need to use <code>$ XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc</code>)

You can also create a simple alias in your shell rc file (e.g. .zshrc), like:
<pre>
alias labwcinit="XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc"
</pre>

See the [https://wiki.alpinelinux.org/wiki/Wayland Wayland] page for a permanent configuration (recommended).

{{Note|
swaylock needs to be able to read your <code>/etc/shadow</code> file to be able to validate your password
}}

== Configuration and Usage ==

LabWC aims to implement the [http://openbox.org/wiki/Help:Contents openbox 3.4] specification, so many things working in OpenBox should be compatible.

Moreover, the project provides [https://github.com/labwc/labwc#4-configure examples for all the configuration files] and some themes, explaining where it must be located each one of them.

For additional information, labwc [https://labwc.github.io/manual.html manpages] and [https://github.com/labwc/labwc/wiki wiki] can be consulted.

[[Category:Desktop]]

LabWC

2022-05-30T09:51:58Z

Adm: Remove double quotes

[https://labwc.github.io LabWC] is a stacking [[Wayland]] compositor. Although [https://github.com/labwc/labwc#1-what-is-this it wasn't intended like that], it can serve as a drop-in replacement for the [[Openbox]] window manager (the same way [[Sway]] is for [[I3wm]]).

This wiki was written starting from a fresh install using the Alpine 3.16 x86 extended .iso. The steps begin from the first reboot after running setup-alpine and performing a sys install to disk.

Many steps below were taken from the [https://wiki.alpinelinux.org/wiki/Sway wiki entry for installing Sway], as both are wlroots-based Wayland compositors. Another interesting page, because of the same reasons, is the [[River]] compositor's.

== Prerequisites ==
{{Note|These steps posted as both Sway and LabWC prerequisites could be applied to almost all wlroots-based Wayland compositors.}}

First, install & configure eudev:

<pre>
# apk add eudev
# setup-udev
</pre>

Then install graphics drivers appropriate to your system:

<pre>
# apk add mesa-dri-gallium # gallium
# apk add mesa-dri-classic # or classic
# apk add mesa-dri-nouveau # for nvidia users
</pre>

The following links contain guides for setting up the video stack.

* [[Intel Video]]
* [[Radeon Video]]

Add yourself to the input and video groups:

<pre>
# adduser $USER input
# adduser $USER video
</pre>

You have to log out and back in for this to take effect.

Install some TTF fonts:

<pre>
# apk add ttf-dejavu
</pre>

Since wlroots 0.14, you need to set up libseat backend if you wish to run labwc directly (without nesting it in another wayland compositor). To do that, [[Enable Community Repository|enable the community repository]] and choose one of the following methods:

<dl>

<dt>Option 1: seatd daemon (recommended)</dt>
<dd>
<pre>
# apk add seatd
# rc-update add seatd
# rc-service seatd start
# adduser $USER seat
</pre>

If you are already logged in as a $USER, you will need to relogin.
</dd>

<dt>Option 2: seatd-launch</dt>
<dd>
<pre>
# apk add seatd-launch
</pre>

When starting labwc, you will need to prefix invocation with <code>seatd-launch</code>.
Note: <code>seatd-launch</code> is a suid binary, so it might be wise to use one of the other methods from a security perspective.
</dd>

<dt>Option 3: elogind daemon</dt>
<dd>

<pre>
# apk add elogind polkit-elogind
# rc-update add elogind
# rc-service elogind start
</pre>

Using <code>elogind</code> will automatically set the necessary permissions, so you can skip adding groups like <code>seat</code> and <code>video</code>

</dd>

</dl>

== Installation ==

We can now install labwc:

<pre>
# 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
swayidle # idle management (DPMS) daemon
</pre>

Note that almost all optional dependencies are the same than Sway's. Another interesting packages are specified into the [https://github.com/labwc/labwc#6-integrate project's README], as it can be [https://labwc.github.io/integration.html#waybar waybar] (included into the Alpine's repository) as navigation bar.

== Running LabWC ==

To run labwc, first set XDG_RUNTIME_DIR to a suitable location (e.g. create a .run folder in your home directory and set it to ~/.run). Then run labwc from the Linux console (dbus-launch is used because pipewire needs it, it is included in dbus-x11 and you may omit it):

<pre>
$ XDG_RUNTIME_DIR=~/.run dbus-launch labwc
</pre>

(if you run labwc with seatd-launch, you will need to use <code>$ XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc</code>)

You can also create a simple alias in your shell rc file (e.g. .zshrc), like:
<pre>
alias labwcinit="XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc"
</pre>

See the [https://wiki.alpinelinux.org/wiki/Wayland Wayland] page for a permanent configuration (recommended).

{{Note|
swaylock needs to be able to read your <code>/etc/shadow</code> file to be able to validate your password
}}

== Configuration and Usage ==

LabWC aims to implement the [openbox.org/wiki/Help:Contents openbox 3.4] specification, so many things working in OpenBox should be compatible.

Moreover, the project provides [https://github.com/labwc/labwc#4-configure examples for all the configuration files] and some themes, explaining where it must be located each one of them.

For additional information, labwc [https://labwc.github.io/manual.html manpages] and [https://github.com/labwc/labwc/wiki wiki] can be consulted.

[[Category:Desktop]]

LabWC

2022-05-30T09:49:21Z

Adm: Replace asterisks with double quotes

[https://labwc.github.io LabWC] is a stacking [[Wayland]] compositor. Although [https://github.com/labwc/labwc#1-what-is-this it wasn't intended like that], it can serve as a drop-in replacement for the [[Openbox]] window manager (the same way [[Sway]] is for [[I3wm]]).

This wiki was written starting from a fresh install using the "Alpine 3.16 x86 extended .iso". The steps begin from the first reboot after running setup-alpine and performing a sys install to disk.

Many steps below were taken from the [https://wiki.alpinelinux.org/wiki/Sway wiki entry for installing Sway], as both are wlroots-based Wayland compositors. Another interesting page, because of the same reasons, is the [[River]] compositor's.

== Prerequisites ==
{{Note|These steps posted as both Sway and LabWC prerequisites could be applied to almost all wlroots-based Wayland compositors.}}

First, install & configure eudev:

<pre>
# apk add eudev
# setup-udev
</pre>

Then install graphics drivers appropriate to your system:

<pre>
# apk add mesa-dri-gallium # gallium
# apk add mesa-dri-classic # or classic
# apk add mesa-dri-nouveau # for nvidia users
</pre>

The following links contain guides for setting up the video stack.

* [[Intel Video]]
* [[Radeon Video]]

Add yourself to the input and video groups:

<pre>
# adduser $USER input
# adduser $USER video
</pre>

You have to log out and back in for this to take effect.

Install some TTF fonts:

<pre>
# apk add ttf-dejavu
</pre>

Since wlroots 0.14, you need to set up libseat backend if you wish to run labwc directly (without nesting it in another wayland compositor). To do that, [[Enable Community Repository|enable the community repository]] and choose one of the following methods:

<dl>

<dt>Option 1: seatd daemon (recommended)</dt>
<dd>
<pre>
# apk add seatd
# rc-update add seatd
# rc-service seatd start
# adduser $USER seat
</pre>

If you are already logged in as a $USER, you will need to relogin.
</dd>

<dt>Option 2: seatd-launch</dt>
<dd>
<pre>
# apk add seatd-launch
</pre>

When starting labwc, you will need to prefix invocation with <code>seatd-launch</code>.
Note: <code>seatd-launch</code> is a suid binary, so it might be wise to use one of the other methods from a security perspective.
</dd>

<dt>Option 3: elogind daemon</dt>
<dd>

<pre>
# apk add elogind polkit-elogind
# rc-update add elogind
# rc-service elogind start
</pre>

Using <code>elogind</code> will automatically set the necessary permissions, so you can skip adding groups like <code>seat</code> and <code>video</code>

</dd>

</dl>

== Installation ==

We can now install labwc:

<pre>
# 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
swayidle # idle management (DPMS) daemon
</pre>

Note that almost all optional dependencies are the same than Sway's. Another interesting packages are specified into the [https://github.com/labwc/labwc#6-integrate project's README], as it can be [https://labwc.github.io/integration.html#waybar waybar] (included into the Alpine's repository) as navigation bar.

== Running LabWC ==

To run labwc, first set XDG_RUNTIME_DIR to a suitable location (e.g. create a .run folder in your home directory and set it to ~/.run). Then run labwc from the Linux console (dbus-launch is used because pipewire needs it, it is included in dbus-x11 and you may omit it):

<pre>
$ XDG_RUNTIME_DIR=~/.run dbus-launch labwc
</pre>

(if you run labwc with seatd-launch, you will need to use <code>$ XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc</code>)

You can also create a simple alias in your shell rc file (e.g. .zshrc), like:
<pre>
alias labwcinit="XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc"
</pre>

See the [https://wiki.alpinelinux.org/wiki/Wayland Wayland] page for a permanent configuration (recommended).

{{Note|
swaylock needs to be able to read your <code>/etc/shadow</code> file to be able to validate your password
}}

== Configuration and Usage ==

LabWC aims to implement the [openbox.org/wiki/Help:Contents openbox 3.4] specification, so many things working in OpenBox should be compatible.

Moreover, the project provides [https://github.com/labwc/labwc#4-configure examples for all the configuration files] and some themes, explaining where it must be located each one of them.

For additional information, labwc [https://labwc.github.io/manual.html manpages] and [https://github.com/labwc/labwc/wiki wiki] can be consulted.

[[Category:Desktop]]

LabWC

2022-05-30T09:46:40Z

Adm: Create LabWC page basing on Sway's (nevertheless, everything posted has been tested both on virtual and real machines)

[https://labwc.github.io LabWC] is a stacking [[Wayland]] compositor. Although [https://github.com/labwc/labwc#1-what-is-this it wasn't intended like that], it can serve as a drop-in replacement for the [[Openbox]] window manager (the same way [[Sway]] is for [[I3wm]]).

This wiki was written starting from a fresh install using the *Alpine 3.16 x86 extended .iso*. The steps begin from the first reboot after running setup-alpine and performing a sys install to disk.

Many steps below were taken from the [https://wiki.alpinelinux.org/wiki/Sway wiki entry for installing Sway], as both are wlroots-based Wayland compositors. Another interesting page, because of the same reasons, is the [[River]] compositor's.

== Prerequisites ==
{{Note|These steps posted as both Sway and LabWC prerequisites could be applied to almost all wlroots-based Wayland compositors.}}

First, install & configure eudev:

<pre>
# apk add eudev
# setup-udev
</pre>

Then install graphics drivers appropriate to your system:

<pre>
# apk add mesa-dri-gallium # gallium
# apk add mesa-dri-classic # or classic
# apk add mesa-dri-nouveau # for nvidia users
</pre>

The following links contain guides for setting up the video stack.

* [[Intel Video]]
* [[Radeon Video]]

Add yourself to the input and video groups:

<pre>
# adduser $USER input
# adduser $USER video
</pre>

You have to log out and back in for this to take effect.

Install some TTF fonts:

<pre>
# apk add ttf-dejavu
</pre>

Since wlroots 0.14, you need to set up libseat backend if you wish to run labwc directly (without nesting it in another wayland compositor). To do that, [[Enable Community Repository|enable the community repository]] and choose one of the following methods:

<dl>

<dt>Option 1: seatd daemon (recommended)</dt>
<dd>
<pre>
# apk add seatd
# rc-update add seatd
# rc-service seatd start
# adduser $USER seat
</pre>

If you are already logged in as a $USER, you will need to relogin.
</dd>

<dt>Option 2: seatd-launch</dt>
<dd>
<pre>
# apk add seatd-launch
</pre>

When starting labwc, you will need to prefix invocation with <code>seatd-launch</code>.
Note: <code>seatd-launch</code> is a suid binary, so it might be wise to use one of the other methods from a security perspective.
</dd>

<dt>Option 3: elogind daemon</dt>
<dd>

<pre>
# apk add elogind polkit-elogind
# rc-update add elogind
# rc-service elogind start
</pre>

Using <code>elogind</code> will automatically set the necessary permissions, so you can skip adding groups like <code>seat</code> and <code>video</code>

</dd>

</dl>

== Installation ==

We can now install labwc:

<pre>
# 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
swayidle # idle management (DPMS) daemon
</pre>

Note that almost all optional dependencies are the same than Sway's. Another interesting packages are specified into the [https://github.com/labwc/labwc#6-integrate project's README], as it can be [https://labwc.github.io/integration.html#waybar waybar] (included into the Alpine's repository) as navigation bar.

== Running LabWC ==

To run labwc, first set XDG_RUNTIME_DIR to a suitable location (e.g. create a .run folder in your home directory and set it to ~/.run). Then run labwc from the Linux console (dbus-launch is used because pipewire needs it, it is included in dbus-x11 and you may omit it):

<pre>
$ XDG_RUNTIME_DIR=~/.run dbus-launch labwc
</pre>

(if you run labwc with seatd-launch, you will need to use <code>$ XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc</code>)

You can also create a simple alias in your shell rc file (e.g. .zshrc), like:
<pre>
alias labwcinit="XDG_RUNTIME_DIR=~/.run dbus-launch seatd-launch labwc"
</pre>

See the [https://wiki.alpinelinux.org/wiki/Wayland Wayland] page for a permanent configuration (recommended).

{{Note|
swaylock needs to be able to read your <code>/etc/shadow</code> file to be able to validate your password
}}

== Configuration and Usage ==

LabWC aims to implement the [openbox.org/wiki/Help:Contents openbox 3.4] specification, so many things working in OpenBox should be compatible.

Moreover, the project provides [https://github.com/labwc/labwc#4-configure examples for all the configuration files] and some themes, explaining where it must be located each one of them.

For additional information, labwc [https://labwc.github.io/manual.html manpages] and [https://github.com/labwc/labwc/wiki wiki] can be consulted.

[[Category:Desktop]]

Desktop environments and Window managers

2022-05-29T09:11:57Z

Adm: Add River to the list of available Wayland tiling compositors

{{TOC right}}

{{Tip|Be sure to add your user to <code>input</code> and <code>video</code> groups.}}

'''Alpine Linux''' has no official desktop. Older versions used Xfce, but now, all GUI and graphical interfaces are optional. many are available and is attempted to be listed below:

== Desktop environments ==

# [[Xfce]]
# [[LXQt]]
# [[KDE|KDE Plasma]]
# [[Gnome]]
# [[MATE]]

== [https://en.wikipedia.org/wiki/Stacking_window_manager Stacking (floating) window managers] ==

* X11:
** [[Openbox]]

* Wayland:
** [[Weston]]
** [[LabWC]]
** [[Wayfire]]

== [https://en.wikipedia.org/wiki/Tiling_window_manager Tiling (dynamic) window managers] ==

* X11:
** [[Dwm]]
** [[I3wm|i3]]
** [[AwesomeWM|Awesome Window Manager]]

* Wayland:
** [[ Sway ]]
** [[River]]

== See Also ==
* [[Installation]]
* [[Alpine newbie]]
* [[Post installation]]
* [[Fonts]]

[[Category:Desktop]]
[[Category:Newbie]]

Desktop environments and Window managers

2022-05-27T15:08:55Z

Adm: Fix Tiling (dynamic) window managers enumeration error by deleting the empty newlines

{{TOC right}}

{{Tip|Be sure to add your user to <code>input</code> and <code>video</code> groups.}}

'''Alpine Linux''' has no official desktop. Older versions used Xfce, but now, all GUI and graphical interfaces are optional. many are available and is attempted to be listed below:

== Desktop environments ==

# [[Xfce]]
# [[LXQt]]
# [[KDE|KDE Plasma]]
# [[Gnome]]
# [[MATE]]

== [https://en.wikipedia.org/wiki/Stacking_window_manager Stacking (floating) window managers] ==

* X11:
** [[Openbox]]

* Wayland:
** [[Weston]]
** [[LabWC]]
** [[Wayfire]]

== [https://en.wikipedia.org/wiki/Tiling_window_manager Tiling (dynamic) window managers] ==

* X11:
** [[Dwm]]
** [[I3wm|i3]]
** [[AwesomeWM|Awesome Window Manager]]

* Wayland:
** [[ Sway ]]

== See Also ==
* [[Installation]]
* [[Alpine newbie]]
* [[Post installation]]
* [[Fonts]]

[[Category:Desktop]]
[[Category:Newbie]]

Desktop environments and Window managers

2022-05-27T15:05:00Z

Adm: Add Weston to the list of available Wayland stacking compositors

{{TOC right}}

{{Tip|Be sure to add your user to <code>input</code> and <code>video</code> groups.}}

'''Alpine Linux''' has no official desktop. Older versions used Xfce, but now, all GUI and graphical interfaces are optional. many are available and is attempted to be listed below:

== Desktop environments ==

# [[Xfce]]
# [[LXQt]]
# [[KDE|KDE Plasma]]
# [[Gnome]]
# [[MATE]]

== [https://en.wikipedia.org/wiki/Stacking_window_manager Stacking (floating) window managers] ==

* X11:
** [[Openbox]]

* Wayland:
** [[Weston]]
** [[LabWC]]
** [[Wayfire]]

== [https://en.wikipedia.org/wiki/Tiling_window_manager Tiling (dynamic) window managers] ==

* X11:

** [[Dwm]]

** [[I3wm|i3]]

** [[AwesomeWM|Awesome Window Manager]]

* Wayland:

** [[ Sway ]]

== See Also ==
* [[Installation]]
* [[Alpine newbie]]
* [[Post installation]]
* [[Fonts]]

[[Category:Desktop]]
[[Category:Newbie]]

Desktop environments and Window managers

2022-05-26T15:32:10Z

Adm: Add LabWC to the list of available Wayland stacking compositors

{{TOC right}}

{{Tip|Be sure to add your user to <code>input</code> and <code>video</code> groups.}}

'''Alpine Linux''' has no official desktop. Older versions used Xfce, but now, all GUI and graphical interfaces are optional. many are available and is attempted to be listed below:

== Desktop environments ==

# [[Xfce]]
# [[LXQt]]
# [[KDE|KDE Plasma]]
# [[Gnome]]
# [[MATE]]

== [https://en.wikipedia.org/wiki/Stacking_window_manager Stacking (floating) window managers] ==

* X11:
** [[Openbox]]

* Wayland:
** [[LabWC]]
** [[Wayfire]]

== [https://en.wikipedia.org/wiki/Tiling_window_manager Tiling (dynamic) window managers] ==

* X11:

** [[Dwm]]

** [[I3wm|i3]]

** [[AwesomeWM|Awesome Window Manager]]

* Wayland:

** [[ Sway ]]

== See Also ==
* [[Installation]]
* [[Alpine newbie]]
* [[Post installation]]
* [[Fonts]]

[[Category:Desktop]]
[[Category:Newbie]]