1
0
Fork
You've already forked tinyrwm
0
forked from river/tinyrwm
Tiny river window manager examples
  • Rust 35.5%
  • C 30.8%
  • Go 17.3%
  • Janet 15.4%
  • Meson 1%
2026年04月17日 22:33:05 +03:00
.builds ci: check for stale generated go protocol code 2026年04月17日 22:33:05 +03:00
c c: ensure children are reaped 2026年04月05日 14:14:29 +02:00
go go: clean up after foot execution 2026年04月17日 22:33:05 +03:00
janet janet: improve janet-pm installation instructions 2026年03月26日 09:26:59 +01:00
LICENSES docs: follow REUSE spec 2026年02月28日 10:26:21 +01:00
rust rust: don't pass format strings to expect() 2026年03月30日 22:05:27 +02:00
README.md docs: improve tinyrwm specification 2026年03月10日 14:22:44 +01:00

tinyrwm

A tiny river window manager, implemented in various languages.

This project aims to help people quickly get started with their own river window manager by following an example in their language of choice.

Contributions adding examples in new languages are very welcome!

All tinyrwm implementations should:

  • Implement the same tiny feature set
  • Be written in the style most idiomatic to their language
  • Use the standard build/packaging approach for the given language ecosystem
  • Be released under the Zero-Clause BSD license

Happy hacking!

Tiny feature set

Keyboard bindings:

  • Super+Space: Spawn the foot terminal
  • Super+q: Close the focused window
  • Super+n: Cycle keyboard focus through windows
  • Super+Escape: Exit the Wayland session

Pointer bindings:

  • Super+Left Click: Interactive move
  • Super+Right Click: Interactive resize

Additionally, clicking on a window must give the window keyboard focus and raise it above all other windows.

This is not a formal specification, tinyrwm.c is the canonical implementation and its behavior should be matched where this specification is unclear/insufficient.