river

A non-monolithic Wayland compositor that leaves window management to a separate program.

These buttons open the developer's own site, repository or store listing in a new tab. wares.gg does not host downloads.

About river

river is a Wayland compositor written in Zig on top of wlroots. Its design is non-monolithic: rather than building in one window management policy, it exposes a river-window-management protocol so a separate window manager program decides how windows are arranged. Small window managers such as tinyrwm are built this way.

The older design, with a swappable layout generator, lives on as river-classic. river is under active development, with commits in September 2026 and CI builds on Alpine, Arch Linux and FreeBSD.

Strengths

  • Window management policy is a separate, replaceable program
  • Documented window management protocol
  • Actively developed with regular releases

Limitations

  • Needs a separate window manager to be useful
  • Building from source requires the Zig toolchain
  • Older configurations belong to river-classic

Details

Pricing
FreeFree and open source.
License
Open source, license not stated
Developer
Isaac Freund
Platforms
Linux
How it runs
Downloadable app
Account
Not required
Works offline
Yes
Best suited for
Linux users who want to build or choose their own Wayland window manager
Categories
Window tools
Last verified
Added
Provenance
Facts checked against the developer's own pages and store listings, 1 sources on file.

Alternatives to river

Compare all

Software that can replace river for an important use case, and what changes if you switch.

  • Sway

    Use an i3-style tiling workflow on Wayland.

    Sway is a complete i3-style tiling Wayland compositor with window management built in, so no separate window manager program is needed.

  • Hyprland

    Arrange Linux application windows with a configurable tiling Wayland compositor.

    Hyprland builds dynamic tiling and animations into the compositor itself, with extensive keyboard and layout configuration instead of a separate policy program.

  • niri

    A scrollable-tiling Wayland compositor that places windows in columns on an endless horizontal strip.

    niri is a Wayland compositor with its own scrollable column tiling and an IPC interface, rather than delegating window management to another program.

  • Wayfire

    A wlroots-based Wayland compositor with plugin-driven window management and 3D desktop effects.

    Wayfire is a wlroots-based compositor that handles window management and 3D effects through plugins, though releases can be far apart.

  • labwc

    A lightweight wlroots-based stacking Wayland compositor inspired by Openbox.

    labwc is a lightweight Openbox-inspired stacking Wayland compositor, so you get floating windows instead of choosing a separate tiling manager.

  • Qtile

    Configure a tiling window manager using Python.

    Qtile is a Python-configured tiling window manager offering both X11 and Wayland back ends, with programmable layouts and widgets included.

Similar software

Related functionality, not necessarily a direct replacement.

Report a wrong fact or a dead link on this listing