A 'dwindling' layout generator for the river Wayland compositor
Overview
Each view occupies half (or a larger proportion if configured) of the remaining space on the display after the views above it in the stack have been tiled.
+--------------------+---------------------+
| 1 | 2 |
| | |
| | |
| | |
| | |
| +----------+----------+
| | 3 | 4 |
| | | |
| | +----------+
| | | 5 |
| | | |
+--------------------+----------+----------+
Installation
This program probably won't be packaged for individual distros. It can be installed by:
Downloading the Binary
GitLab compiles the binary for amd64 automatically. One should be attached to each release - including the latest one.
Just download the binary file and place it somewhere in your PATH.
Compiling the Code
Clone the repository and compile the code:
Then place the resulting executable file in target/release somewhere in your PATH.
Installing with Cargo
Install the program with Cargo from crates.io:
Ensure that ~/.cargo/bin is in your PATH.
Usage
river must be told to use river-dwindle to lay out views. For example, to change the default layout from rivertile to river-dwindle in a shell script river init file, change:
&
To the following:
&
Troubleshooting
One way to troubleshoot issues is to run river-dwindle in a terminal and watch the error messages it outputs.
Another is to redirect its outputs to a file which can be checked in the event of an error. You can specify how you'd like this to happen in your init file. For example:
&
The above starts the layout generator in the background and saves the messages it outputs to the named file.
Credits
This project uses the river-layout-toolkit package to integrate with river. The code was written with reference to a BSP layout written using the same library.