Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
RIVERTILE(1)		    General Commands Manual		  RIVERTILE(1)

NAME
       rivertile - 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  ad-
       ditionally  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.  (De-
	   fault: 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  develop-
       ment, see <https://isaacfreund.com/software/river>.

SEE ALSO
       river(1), riverctl(1)

				  2025-04-24			  RIVERTILE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=rivertile&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help