River: Difference between revisions

From Alpine Linux
No edit summary
Line 8: Line 8:
Many steps below were taken from the [https://wiki.alpinelinux.org/wiki/Sway wiki entry for installing Sway].
Many steps below were taken from the [https://wiki.alpinelinux.org/wiki/Sway wiki entry for installing Sway].


== First Boot ==
== Installation ==


Login as root, create a new user and update group membership:
Login as root, create a new user and update group membership:
Line 26: Line 26:


Verify that you can run commands with sudo.
Verify that you can run commands with sudo.
== Installation ==


Edit the repositories file and uncomment the community and testing repos. For 3.14.2, we need edge/community to get the correct software versions to support River:
Edit the repositories file and uncomment the community and testing repos. For 3.14.2, we need edge/community to get the correct software versions to support River:
Line 56: Line 54:


{{Cmd|sudo apk add river river-doc mandoc}}
{{Cmd|sudo apk add river river-doc mandoc}}
Edit the repositories file again to toggle back to the 3.14/community repository before installing additional software:
{{Cat|/etc/apk/repositories|
http://dl-cdn.alpinelinux.org/alpine/v3.14/main
http://dl-cdn.alpinelinux.org/alpine/v3.14/community
#http://dl-cdn.alpinelinux.org/alpine/edge/main
#http://dl-cdn.alpinelinux.org/alpine/edge/community
http://dl-cdn.alpinelinux.org/alpine/edge/testing
}}


Install your choice of additional applications:
Install your choice of additional applications:
Line 90: Line 78:


{{Cmd|1=XDG_RUNTIME_DIR=/tmp river}}
{{Cmd|1=XDG_RUNTIME_DIR=/tmp river}}
== 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]]
[[Category:Desktop]]

Revision as of 23:37, 11 November 2021

Note: This is currently not working as written. Updates in Progress

River is a dynamic tiling Wayland compositor. An introduction to River can be found in this blog post by the author for the 0.1.0 release.

This wiki was written starting from a fresh install using the Alpine 3.14.2 x86_64 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 wiki entry for installing Sway.

Installation

Login as root, create a new user and update group membership:

adduser sodface addgroup sodface audio addgroup sodface input addgroup sodface video addgroup sodface wheel

Install sudo and run visudo, uncommenting the desired permissions for the wheel group:

apk add sudo && visudo

Logout and log back in as the new user.

Test ssh login from a remote computer.

Verify that you can run commands with sudo.

Edit the repositories file and uncomment the community and testing repos. For 3.14.2, we need edge/community to get the correct software versions to support River:

Contents of /etc/apk/repositories

http://dl-cdn.alpinelinux.org/alpine/v3.14/main #http://dl-cdn.alpinelinux.org/alpine/v3.14/community #http://dl-cdn.alpinelinux.org/alpine/edge/main http://dl-cdn.alpinelinux.org/alpine/edge/community http://dl-cdn.alpinelinux.org/alpine/edge/testing

Install & configure eudev:

sudo apk add eudev sudo setup-udev

Then install graphics drivers appropriate to your system:

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

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

Install River and the documentation:

sudo apk add river river-doc mandoc

Install your choice of additional applications:

This list includes icons, browser, fonts, and a terminal emulator named foot which is the default in River's sample init file that we will use later.

sudo apk add adwaita-icon-theme firefox foot ttf-dejavu

Running River

Before running River for the first time, copy the sample init file from /etc/river to ~/.config:

install -Dm0755 /etc/river/init -t ~/.config/river

Set seatd to start automatically at next boot and also manually start it for this session:

sudo rc-update add seatd sudo rc-service seatd start

sudo addgroup sodface seat

Logout and log back in again.

Start River:

XDG_RUNTIME_DIR=/tmp river