oxbow

demo.webm

oxbow is a dynamic tiling window manager for the Wayland compositor River, written in OCaml. Inspired by dwm and river-classic, oxbow aims to manage your windows predictably. Configure it with a simple init script, and control it with oxctl from your own scripts.

Features

• Tags: Group windows with tag sets, per-tag layouts, and operations on tags.
• Layouts: dwm-like tiling, niri-ish scrolling in four orientations, "alt-tab" overview, and pure floating.
• Windows: Scratchpads, sticky windows, user labels, window swallowing, and drag with retile.
• Rules: Regex window matching to configure initial tags, output, floating, size, and presentation.
• IPC: Control windows, configure tags, query objects, and subscribe to events.

Documentation

Full documentation is available at oxbow-wm.readthedocs.io.

• Installation
• River Setup
• Getting Started
• oxctl Reference
• Defaults
• Waybar Integration

Installation

oxbow requires river 0.4.6 or later.

Install with opam:

opam pin add oxbow https://github.com/3L0C/oxbow.git

Or with Nix:

nix profile install github:3L0C/oxbow

See the installation guide for build dependencies, NixOS and Home Manager configuration, and shell completion.

Contributing

Contributions are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request.

AI disclosure

Claude Code was used in the following ways:

• design discussions
• debugging

I've written and will continue to write the code.