River: Difference between revisions

From Alpine Linux
Line 10: Line 10:
== Installation ==
== Installation ==


Login as root, create a new user and update group membership:
Login as root.
{{Cmd|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:
{{Cmd|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:
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 38: Line 23:
Install & configure eudev:
Install & configure eudev:


{{Cmd|sudo apk add eudev
{{Cmd|apk add eudev
sudo setup-udev}}
setup-udev}}


Then install graphics drivers appropriate to your system:
Then install graphics drivers appropriate to your system:


{{Cmd|sudo apk add mesa-dri-gallium  # gallium
{{Cmd|apk add mesa-dri-gallium  # gallium
sudo apk add mesa-dri-classic  # or classic}}
apk add mesa-dri-classic  # or classic}}


The following links contain guides for setting up the video stack.
The following links contain guides for setting up the video stack.
Line 53: Line 38:
Install River and the documentation:
Install River and the documentation:


{{Cmd|sudo apk add river river-doc mandoc}}
{{Cmd|apk add river river-doc mandoc}}


Install your choice of additional applications:
Install your choice of additional packages:


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.
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|sudo apk add adwaita-icon-theme foot ttf-dejavu}}
{{Cmd|apk add adwaita-icon-theme foot ttf-dejavu}}
 
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 sudo && visudo}}
 
Logout and log back in as the new user.


== Running River ==
== Running River ==

Revision as of 23:44, 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.

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:

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 links contain guides for setting up the video stack.

Install River and the documentation:

apk add river river-doc 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.

apk add adwaita-icon-theme foot ttf-dejavu

Create a new user and update group membership:

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:

apk add 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 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