River: Difference between revisions
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]. | ||
== | == 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. | ||
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}} | ||
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}} | ||
[[Category:Desktop]] | [[Category:Desktop]] |
Revision as of 23:37, 11 November 2021
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
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