ashrwm

A window manager for the river Wayland compositor.

ashrwm is currently around 700 lines of Janet but capable enough to use as my daily driver.

Features

• Dynamic tiling with layouts
  • Live layout change
• Tags
  • Each window has exactly one tag
  • An arbitrary number of tags can be displayed at once on each output
  • Each tag can be displayed on at most one output at a time
• Floating windows
• Sticky windows
• Focus follows mouse
• libinput configuration
• Hot reload configuration
• A REPL

Install

AUR

paru -S ashrwm

OR

paru -S ashrwm-git

Building

Run zig build. All dependencies will be fetched by Zig and built from source.

Requires Zig 0.15, a statically linked Zig binary can be obtained from https://ziglang.org/download/.

Usage

Run ashrwm inside river. Requires river's main branch (version 0.4.0-dev). It may be useful to start ashrwm from river's init script.

On startup ashrwm will evaluate $XDG_CONFIG_HOME/ashrwm/config.janet if the file exists. If $XDG_CONFIG_HOME is not set, ~/.config/ashrwm/config.janet will be tried instead.

Passing a file to ashrwm as an argument will evaluate that file instead.

See example/config.janet.

credits

ashrwm is a fork of rijan made by the developer of river Isaac Freund