User:B

2022-04-08T12:15:40Z

B: Created page with "Hi, I'm Martin, trying out alpine for the first time :)"

Hi,

I'm Martin, trying out alpine for the first time :)

Sway

2022-04-08T12:08:41Z

[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
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]]

Alpine Linux - User contributions [en]

User:B

Sway