1
0
Fork
You've already forked tinyrwm
0
forked from river/tinyrwm
a selection of tiny river window manager examples, probably lagging behind the main version of this repo at river/tinyrwm
  • Rust 29.4%
  • C 25.5%
  • Lua 16.9%
  • Go 14.5%
  • Janet 12.8%
  • Other 0.9%
2026年05月27日 22:48:10 +02:00
.builds ci: check if lua implementation compiles 2026年05月01日 11:48:50 +02:00
c c: Fix tiny typo "indentifier" -> "identifier" 2026年05月27日 22:48:10 +02:00
go go: update deps 2026年05月25日 23:03:25 +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
lua lua: improve build instructions 2026年05月01日 11:54:14 +02:00
rust rust: don't pass format strings to expect() 2026年03月30日 22:05:27 +02:00
README.md docs: encourage incremental improvements 2026年05月01日 12:10:30 +02: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 implementations in new languages are very welcome, as are contributions simplifying or otherwise improving existing implementations!

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.