package oxbow

All checked builds pass
  1. Overview
  2. Docs
Dynamic window manager for the river Wayland compositor

Install

dune-project
 Dependency

Authors

Maintainers

Sources

v0.1.1.tar.gz
md5=a182e6d368a65e6752771e41e651713f
sha512=020d2c7f9f4e06966ca56695e24eb0b41dd12500aa65d2cd9b56e03068bbb6ea7770de0a33c04f0d054bd474bee8c2b36bb46af86266c9823490e1bd0810c027

Description

oxbow is a window manager for River 0.4.6+, written in OCaml. It manages windows with built-in dynamic layouts.

The package installs two executables:

  • oxbow: the window manager
  • oxctl: a CLI client for commands, queries, and event subscriptions

Configuration is an init script of oxctl commands.

Added to opam-repository:

README

oxbow logo oxbow

demo

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

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.

Dependencies (17)

  1. yojson >= "3.0"
  2. xkbcommon >= "0.1"
  3. wayland >= "2.3"
  4. re >= "1.12"
  5. ppx_yojson_conv_lib >= "v0.17"
  6. ppx_yojson_conv >= "v0.17"
  7. logs >= "0.10"
  8. landmarks-ppx >= "1.7"
  9. landmarks >= "1.7"
  10. fmt >= "0.11"
  11. eio_posix >= "1.3"
  12. eio_main >= "1.2"
  13. eio >= "1.3"
  14. cmdliner >= "2.1"
  15. dune-build-info >= "3.22"
  16. ocaml >= "5.4"
  17. dune >= "3.22"

Dev Dependencies (2)

  1. odoc with-doc
  2. cstruct >= "6.2" & with-test

Optional Dependencies

None

Used by

None

Conflicts

None

Build status

Results of building oxbow with each compiler on check.ci.ocaml.org, run of against opam-repository 78c202b. All results for this package.

Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.

Version OCaml 4.11 OCaml 4.14 OCaml 5.2 OCaml 5.4 OCaml 5.5
0.1.1 (this version) n/a n/a n/a good good
  • good Package successfully built
  • partial One of the dependencies failed to build
  • bad Package failed to build
  • n/a Package is not available in this environment
  • internal Internal failure