River

2023-05-14T15:57:48Z

Maalos: fixed some styling issues

[https://github.com/riverwm/river River] is a dynamic tiling [[Wayland]] compositor. An introduction to River can be found in [https://isaacfreund.com/blog/river-intro/ this blog post] by the developer 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 [https://wiki.alpinelinux.org/wiki/Sway wiki entry for installing Sway].

== Installation ==

Login as root.

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:
{{Cat|/etc/apk/repositories|
#http://dl-cdn.alpinelinux.org/alpine/v3.17/main
#http://dl-cdn.alpinelinux.org/alpine/v3.17/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 {{Pkg|eudev}}:

{{Cmd|# apk update
# apk add {{Pkg|eudev}}
# setup-devd udev}}

Then install the mesa gallium drivers:

{{Cmd|# apk add {{Pkg|mesa-dri-gallium}}}}

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

* [https://wiki.alpinelinux.org/wiki/Intel_Video Intel Video]
* [https://wiki.alpinelinux.org/wiki/Radeon_Video Radeon Video]

Install River and the documentation:

{{Cmd|# apk add {{Pkg|river}} {{Pkg|river-doc}} {{Pkg|mandoc}}}}

Install your choice of additional packages:

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

{{Cmd|# apk add {{Pkg|adwaita-icon-theme}} {{Pkg|foot}} {{Pkg|ttf-dejavu}}}}

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

{{Cmd|# rc-update add {{Pkg|seatd}}
# rc-service {{Pkg|seatd}} start}}

Create a new user and update group membership:
{{Cmd|# adduser sodface
# addgroup sodface audio
# addgroup sodface input
# addgroup sodface seat
# addgroup sodface video
# addgroup sodface wheel
}}

Install sudo and run visudo, uncommenting the desired permissions for the wheel group:
{{Cmd|# apk add {{Pkg|sudo}} && visudo}}

Logout and log back in as the new user.

== Running River ==

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

{{Cmd|install -Dm0755 /usr/share/doc/river/examples/init -t ~/.config/river}}

Set [[Wayland#XDG_RUNTIME_DIR|XDG_RUNTIME_DIR]] and then start River:

{{Cmd|1=river}}

[[Category:Desktop]]

== Notes ==

Following are a few notes that are most certainly not related to River whatsoever but rather discovered while running River so I'm tacking them onto the end of this wiki.

Firefox 89.0.1 complains on launch "glxtest: libpci missing", resolved by:

{{Cmd|sudo apk add {{Pkg|pciutils-libs}}}}

Firefox 89.0.1 complains continuously "Unable to load hand2 from the cursor theme", resolved by:

{{Cmd|mkdir -p ~/.icons/default
ln -s /usr/share/icons/Adwaita/cursors .icons/default/cursors}}

Alpine Linux - User contributions [en]

River