Sway

2020-11-30T12:27:49Z

Unknownuserrr:

[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 search mesa-dri
# apk add mesa-dri-intel # example
</pre>

The following contains guides per-graphics for setting the video stack up.

For Intel:
<pre>
https://wiki.alpinelinux.org/wiki/Intel_Video
</pre>

For Radeon:
<pre>
https://wiki.alpinelinux.org/wiki/Radeon_Video
</pre>

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.

== Installation ==

We can now install sway:

<pre>
# apk add sway sway-doc
# apk add \ # Install optional dependencies:
xorg-server-xwayland \ # strongly reccommended for compatibility reasons
alacritty \ # default terminal emulator
dmenu \ # default application launcher
swaylock \ # lockscreen tool
swayidle # idle management (DPMS) daemon
</pre>

== Running Sway ==

To run sway, first set XDG_RUNTIME_DIR to a suitable location (e.g. /tmp). Install & configure elogind to skip this step. Then run sway from the Linux console:

<pre>
$ XDG_RUNTIME_DIR=/tmp sway
</pre>

Add this to a script if it becomes tedious.

== 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.

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

[[Category:Desktop]]

Alpine Linux - User contributions [en]

Sway