-
-
Notifications
You must be signed in to change notification settings - Fork 154
Home
Here you will find information, guides, tips and tricks that do not fit into the main documentation.
Feel free to contribute!
- How do I reload the configuration file?
- Wait, the configuration is a shell script?
- How can I configure outputs?
- My windows are not tiled!
- How do I set a wallpaper?
- River does not appear in my display managers session selector!
- How do I disable GTK decorations (e.g. title bar)?
- What are the minimum hardware requirements for running river?
You don't. The default river init is a shell script executing riverctl a bunch of times to configure river. If you want to change a setting, just run the corresponding riverctl command again with the updated value.
The default one is a shell script, yes. However, since river just tries to run an executable file called init on startup (for possible locations of the file see the man page), it can be anything. You could configure river using a python script or a compiled C program if you wanted to, just make sure the file is executable and in the right place.
River implements the wlr-output-management-unstable-v1 protocol extension to allow external programs to configure its output. To keep river simple, this is the only way to configure outputs. See the Recommended Software section of this wiki to find out which output configuration programs we recommend.
You probably forgot to either run a layout generator or to configure the layout namespace of the output. River does not have any built-in layouts and depends entirely on external programs to dynamically arrange views. If no layout generator is active for the current output, river will fall back to floating window management. River is perfectly usable in this floating mode, thanks to the move, resize and snap commands.
To use a layout generator, make sure it is running (they are constantly running daemons, not one-shot programs) and then enable it in river (either per output or as a global default).
As an example, this following snippet will start rivertile, rivers default and bundled layout generator, in the background and then tells river to use it on the currently focused output.
riverctl spawn rivertile
riverctl output-layout rivertile
Behold: The name of the layout is not guaranteed to be equal to the filename of the executable.
River itself does not support displaying image. Instead you will have to use an external program, like for example swaybg. You can imagine these wallpaper programs to be like image viewers that just run in the background (using the layer shell).
River does not ship with a session file because display managers are not officially supported.
You can however easily create your own river session file. Just create a file called river.desktop in /usr/share/wayland-sessions/ with the following content:
[Desktop Entry]
Name=River
Comment=A dynamic tiling Wayland compositor
Exec=river
Type=Application
However note that not every display manager supports Wayland sessions.
Try adding dtoverlay=vc4-kms-v3d in /boot/config.txt.
River by default disables CSD (Client-side decoration) but GTK use an obsolete protocol. See #24 for more information.
In the meantime for Firefox you can do this: Right click on toolbar and click on "Customize Toolbar...". In the bottom, uncheck "Title Bar".
River runs well on a ThinkPad X200 from 2008. Any newer hardware should be perfectly fine, as long as you don't use proprietary graphics drivers.