mriya

is a scrolling x11 window manager.

to go more in-depth

scrolling means that windows are arranged on a ribbon-style horizontal strip that the user can scroll through.

mriya is heavily inspired by niri and i3

mriya has been tested on

• generic linux x86_64
• freebsd 15.1 x86_64
• netbsd 10.1 x86_64
• openindiana hipster 2026.04 x86_64

compile

git clone https://github.com/hokum-b/mriya
cd mriya/
make

(the binary is produced at ./mriya.)

deps

• libX11-devel (xlib)
• libxkbfile-devel
• libxkbcommon-devel
• alsamixer (optional, for volume keys)
• brightnessctl (optional, for brightness keys)

install

sudo make install

this copies mriya to /usr/local/bin/mriya.

or you can sudo cp mriya to /usr/local/bin

run

startx ./mriya

or startx ./mriya (refer to the install section above.)

set-up with display managers

• create a /usr/share/xsessions/mriya.desktop
• paste

[Desktop Entry]
Name=mriya
Comment=scrolling x11 window manager
Exec=mriya
Type=Application
DesktopNames=mriya

notes

• some distros don't have /usr/local/bin in $PATH by default.
• recompilation is required after editing src/config.h.

detailed documentation

refer to the website

1.0 release goals

• stable with little to no crashes.
• hot reloads
• plenty of other qol features

license

mriya is licensed under the ISC license

note

mriya is ai free and will remain ai free.