River: Difference between revisions
Drsheppard (talk | contribs) No edit summary |
m (minor formatting, content unchanged) |
||
| 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. | ||
| Line 18: | Line 18: | ||
}} | }} | ||
Install & configure eudev: | Install & configure {{Pkg|eudev}}: | ||
{{Cmd|apk update | {{Cmd|# apk update | ||
apk add eudev | # apk add eudev | ||
setup-devd udev}} | # setup-devd udev}} | ||
Then install the mesa gallium drivers: | Then install the mesa gallium drivers: | ||
{{Cmd|apk add mesa-dri-gallium}} | {{Cmd|# apk add mesa-dri-gallium}} | ||
The following links contain guides for setting up the video stack. | The following links contain guides for setting up the video stack. | ||
| Line 35: | Line 35: | ||
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}} {{Pkg|mandoc}}}} | ||
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}} | |||
{{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: | Set seatd to start automatically at next boot and also manually start it for this session: | ||
{{Cmd|rc-update add seatd | {{Cmd|# rc-update add {{Pkg|seatd}} | ||
rc-service seatd start}} | # rc-service seatd start}} | ||
Create a new user and update group membership: | Create a new user and update group membership: | ||
{{Cmd|adduser sodface | {{Cmd|# adduser sodface | ||
addgroup sodface audio | # addgroup sodface audio | ||
addgroup sodface input | # addgroup sodface input | ||
addgroup sodface seat | # addgroup sodface seat | ||
addgroup sodface video | # addgroup sodface video | ||
addgroup sodface wheel | # addgroup sodface wheel | ||
}} | }} | ||
Install sudo and run visudo, uncommenting the desired permissions for the wheel group: | Install sudo and run visudo, uncommenting the desired permissions for the wheel group: | ||
{{Cmd|apk add sudo && visudo}} | {{Cmd|# apk add {{Pkg|sudo}} && visudo}} | ||
Logout and log back in as the new user. | Logout and log back in as the new user. | ||
| Line 78: | Line 79: | ||
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|sudo 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}} | ||
Revision as of 08:39, 3 May 2023
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
Install & configure eudev:
# apk update # apk add eudev # setup-devd udev
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 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
Set seatd to start automatically at next boot and also manually start it for this session:
# rc-update add seatd
- rc-service seatd start
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 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:
sudo 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