1
0
Fork
You've already forked tinyrwm
0
forked from river/tinyrwm
Tiny river window manager examples
  • Scheme 29.7%
  • Rust 20.4%
  • C 17.8%
  • Lua 11.8%
  • Go 10%
  • Other 10.3%
2026年05月03日 10:43:48 +02:00
.builds ci: check if lua implementation compiles 2026年05月01日 11:48:50 +02: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
guile guile: install guile-wayland-scm in manifest 2026年05月03日 10:43:48 +02:00
janet janet: improve janet-pm installation instructions 2026年03月26日 09:26:59 +01:00
LICENSES guile: remove unused license 2026年05月03日 10:43:48 +02: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.