Sway: Difference between revisions

From Alpine Linux
(mesa-dri-intel and others are deprecated, replace with mesa-dri-gallium or mesa-dri-classic)
(Add TTF fonts to Prerequisites)
Line 30: Line 30:


You have to log out and back in for this to take effect.  
You have to log out and back in for this to take effect.  
And install some TTF fonts, for example:
<pre>
# apk add ttf-dejavu
</pre>


== Installation ==
== Installation ==

Revision as of 20:51, 27 July 2021

Sway is a tiling Wayland compositor. It's a drop-in replacement for the i3 window manager.

Prerequisites

First, install & configure eudev:

# apk add eudev
# setup-udev

Then install graphics drivers appropriate to your system:

# apk add mesa-dri-gallium  # gallium
# apk add mesa-dri-classic  # or classic

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

Add yourself to the input and video groups:

# adduser $USER input
# adduser $USER video

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

And install some TTF fonts, for example:

# apk add ttf-dejavu

Installation

We can now install sway:

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

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:

$ XDG_RUNTIME_DIR=/tmp sway

See the Wayland page for a permanent configuration

Configuration and Usage

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

For additional information, start at man 5 sway and read the upstream FAQ.