River: Difference between revisions

From Alpine Linux
No edit summary
m (→‎Notes: Make filepath less ambiguous.)
 
(22 intermediate revisions by 9 users not shown)
Line 1: Line 1:
[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.   
[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.  
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].
Many steps below were taken from the [[Sway|wiki entry for installing Sway]].


== Installation ==
== Installation ==
Line 11: Line 11:
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:
{{Cat|/etc/apk/repositories|
{{Cat|/etc/apk/repositories|
http://dl-cdn.alpinelinux.org/alpine/v3.14/main
#http://dl-cdn.alpinelinux.org/alpine/v3.17/main
#http://dl-cdn.alpinelinux.org/alpine/v3.14/community
#http://dl-cdn.alpinelinux.org/alpine/v3.17/community
#http://dl-cdn.alpinelinux.org/alpine/edge/main
http://dl-cdn.alpinelinux.org/alpine/edge/main
http://dl-cdn.alpinelinux.org/alpine/edge/community
http://dl-cdn.alpinelinux.org/alpine/edge/community
http://dl-cdn.alpinelinux.org/alpine/edge/testing
http://dl-cdn.alpinelinux.org/alpine/edge/testing
}}
}}


Install & configure eudev:
{{:Include:Setup_Device_Manager}}


{{Cmd|apk update
Then install the mesa gallium drivers:
apk add eudev
setup-udev}}


Then install graphics drivers appropriate to your system:
{{Cmd|# apk add {{Pkg|mesa-dri-gallium}}}}
 
{{Cmd|apk add mesa-dri-gallium # gallium
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.


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


Install River and the documentation:
Install River and the documentation:


{{Cmd|apk add river river-doc mandoc}}
{{Cmd|# apk add {{Pkg|river}} {{Pkg|river-doc}}}}
 
<code>river-doc</code> is required if you want use the example config.


Install your choice of additional packages:
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.
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 adwaita-icon-theme foot ttf-dejavu}}
Set seatd to start automatically at next boot and also manually start it for this session:
{{Cmd|rc-update add seatd
rc-service seatd start}}


Create a new user and update group membership:
{{Cmd|# apk add {{Pkg|adwaita-icon-theme}} {{Pkg|foot}} {{Pkg|font-dejavu}}}}
{{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:
[[Seatd|Install and configure seatd to start automatically]].
{{Cmd|apk add sudo && visudo}}


Logout and log back in as the new user.
Logout and log back in as the new user.
Line 64: Line 47:
== Running River ==
== Running River ==


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


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


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


{{Cmd|1=XDG_RUNTIME_DIR=/tmp river}}
{{Cmd|1=river}}
 
[[Category:Desktop]]


== Notes ==
== Notes ==
Line 79: Line 60:


Firefox 89.0.1 complains on launch "glxtest: libpci missing", resolved by:
Firefox 89.0.1 complains on launch "glxtest: libpci missing", resolved by:
{{Cmd|sudo apk add pciutils-libs}}
 
{{Cmd|apk add {{Pkg|pciutils-libs}}}}


Firefox 89.0.1 complains continuously "Unable to load hand2 from the cursor theme", resolved by:
Firefox 89.0.1 complains continuously "Unable to load hand2 from the cursor theme", resolved by:
{{Cmd|mkdir -p ~/.icons/default
{{Cmd|mkdir -p ~/.icons/default
ln -s /usr/share/icons/Adwaita/cursors .icons/default/cursors}}
ln -s /usr/share/icons/Adwaita/cursors ~/.icons/default/cursors}}
 
[[Category:Compositor]]
[[Category:Desktop]]
[[Category:Wayland]]

Latest revision as of 02:22, 3 June 2024

River is a dynamic tiling Wayland compositor. An introduction to River can be found in 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 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.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

Setting up eudev on a desktop system is recommended:

# setup-devd udev

For more details and advanced instructions see Device Manager.

Then install the mesa gallium drivers:

# apk add mesa-dri-gallium

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

Install River and the documentation:

# apk add river river-doc

river-doc is required if you want use the example config.

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 font-dejavu

Install and configure seatd to start automatically.

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:

install -Dm0755 /usr/share/doc/river/examples/init -t ~/.config/river

Set XDG_RUNTIME_DIR and then start River:

river

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:

apk add pciutils-libs

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

mkdir -p ~/.icons/default ln -s /usr/share/icons/Adwaita/cursors ~/.icons/default/cursors