rivertile - Man Page
tiled layout generator for river
Synopsis
rivertile [options]
Description
rivertile is a layout generator for river(1). It provides a simple tiled layout with split main/secondary stacks. The initial state may be configured with various options passed on startup. Some values may additionally be modified while rivertile is running with the help of riverctl(1).
Options
- -h
Print a help message and exit.
- -version
Print the version number and exit.
- -view-padding pixels
Set the padding around views in pixels. (Default: 6)
- -outer-padding pixels
Set the padding around the edge of the layout area in pixels. (Default: 6)
- -main-location [top|bottom|left|right]
Set the initial location of the main area in the layout. (Default: left)
- -main-count count
Set the initial number of views in the main area of the layout. (Default: 1)
- -main-ratio ratio
Set the initial ratio of the main area to total layout area. The ratio must be between 0.1 and 0.9, inclusive. (Default: 0.6)
Commands
These commands may be sent to rivertile at runtime with the help of riverctl(1).
main-location [top|bottom|left|right]
Set the location of the main area in the layout.
main-count value
Set or modify the number of views in the main area of the layout. If value is prefixed by a +/- sign, value is added/subtracted from the current count. If there is no sign, the main count is set to value. Note that the main count cannot be decreased below 1.
main-ratio value
Set or modify the ratio of the main area to total layout area. If value is prefixed by a +/- sign, value is added/subtracted from the current ratio. If there is no sign, the main ratio is set to value. Note that the ratio will always be clamped to the range 0.1 to 0.9.
Examples
Start rivertile with 4 pixels outer padding and the top main location:
rivertile -outer-padding 4 -main-location top
Increase the main ratio by 0.1 at runtime:
riverctl send-layout-cmd rivertile "main-ratio +0.1"
Set the main count to 3 at runtime:
riverctl send-layout-cmd rivertile "main-count 3"
Authors
Maintained by Isaac Freund <mail@isaacfreund.com> who is assisted by open source contributors. For more information about river's development, see <https://isaacfreund.com/software/river>.