River

[edit]

• Overview
• Details
• About this entry

River

https://github.com/riverwm/river
A dynamic tiling Wayland compositor with flexible runtime configuration

River is a window manager for Wayland that is currently under development. River’s window management is based on a linear stack of windows much like dwm. It ships with a layout generator, rivertile, that provides a few simple layouts for those who don’t need anything custom or fancy.

Instead of traditional workspaces, river supports tags. Each window may be assigned one or more tags and multiple tags may be displayed at once.

All configuration and control of river happens at runtime through the riverctl tool. It can be used to create keybindings, move focus between windows, set the border color, etc. River doesn’t have any traditional configuration file, instead it runs an arbitrary executable on startup which is generally a shell script invoking riverctl to setup the user’s desired configuration.

Features

• Simple and predictable behavior, river should be easy to use and have a low cognitive load.
• Window management based on a stack of views and tags.
• Dynamic layouts generated by external, user-written executables. A default rivertile layout generator is provided.
• Scriptable configuration and control through a custom Wayland protocol and separate riverctl binary implementing it.

Documentation

https://github.com/riverwm/river/wiki

IRC general channel

irc://irc.libera.chat/river

Download

https://github.com/riverwm/river/releases/tag/v0.1.3

(testing)

VCS Checkout

git clone https://github.com/riverwm/river

Categories

• Interface:window-manager
• Interface:wayland-window-system
• Runs-on:GNU/Linux

Licensing

License

Verified by

Verified on

Notes

License

GPL-3.0-only

Verified by

Panos Alevropoulos

Verified on

17 March 2022

Notes

https://github.com/riverwm/river/blob/master/LICENSE

Leaders and contributors

Contact(s)	Role
Isaac Freund	Developer

Resources and communication

Software prerequisites

Kind	Description
Required to build	xkbcommon
Required to build	wlroots 0.15
Required to build	libevdev
Required to build	scdoc
Required to build	pkg-config
Required to build	wayland-protocols
Required to build	pixman
Required to build	wayland
Required to build	zig 0.9

Entry

"GPL-3.0-only" is not in the list (ACEL, AFL-3.0, AGPL-1.0, AGPL-1.0-or-later, AGPL-3.0, AGPL-3.0-or-later, AGPL-3.0-or-later-with-exception, AGPL-3.0-with-exception, AGPLv1orlater, AGPLv3, ...) of allowed values for the "License" property.

Property "Submitted by" (as page type) with input value "{{{Submitted by}}}" contains invalid characters or is incomplete and therefore can cause unexpected results during a query or annotation process. "{{{Submitted date}}}" contains an extrinsic dash or other characters that are invalid for a date interpretation.