this post was submitted on 18 Mar 2026
11 points (100.0% liked)
Emacs
612 readers
1 users here now
founded 2 years ago
MODERATORS
you are viewing a single comment's thread
view the rest of the comments
view the rest of the comments
Oh, this is neat.
I do kind of wish that there was more of a summary of how it works on the page from a user standpoint. For example, the page links to niri, which the author previously used. That describes the basic niri paradigm right up top:
I mean, you can very quickly skim that and get a rough idea of the way niri would work if you invested the time to download it and get it set up and use it.
It does say that reka uses river, and maybe that implies certain conventions or functionality, but I haven't used any river-based window managers, so it doesn't give me a lot of information.
Hi, I'm the author of this.
There's currently very little user-facing documentation; in general you can imagine it to work approximately the same way as EXWM. Wayland windows (e.g. your browser) just become another buffer inside of a full-screen Emacs frame, and then you use the normal Emacs window management paradigm.
This project is pretty new (river 0.4.0 just came out, and I wrote this originally two weeks ago, with last week being the first week where it was actually usable). There's a few more things I want to implement and clean up before I focus on making it more usable, right now the early users are mostly experienced EXWM-users and so on, i.e. people who don't really require any hand-holding. I think it makes sense to put off the "user-friendliness" until there's a certain level of polish and stability in the core features.
From what I understand, River aims to separate the compositor programme from the window management programme, sort of like how things worked in X11. River's author gave a good introduction to it here.