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

• 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.

startx mriya

• 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.

edit /$HOME/.config/mriya/mriya.rc

refer to the website

• stable with little to no crashes.
• hot reloads
• proper documentation

mriya is licensed under the 3 Clause BSD License

if you create a fork of mriya, please do not license it under the gpl, if you'd like to read up on why refer to this article (not written by me).