River is a dynamic tiling Wayland compositor with a flexible runtime configuration. River can either be run nested in an X11/Wayland session or directly from a tty using KMS/DRM. Simply run the river command. Usually this executable is a shell script invoking riverctl(1) to create mappings, start programs such as a layout generator or status bar, and perform other 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
  • Install from your package manager

Project Samples

Project Activity

See All Activity >