Sway

From Alpine Linux
Revision as of 20:32, 27 July 2021 by Jirutka (talk | contribs) (mesa-dri-intel and others are deprecated, replace with mesa-dri-gallium or mesa-dri-classic)

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.

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.