is a scrolling x11 window manager.

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

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

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

(the binary is produced at ./mriya.)

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

sudo make install

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

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

startx ./mriya

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

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

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

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

refer to the website

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

mriya is licensed under the ISC license

mriya is ai free and will remain ai free.