RagnarWM

Overview

Ragnar is a minimal window manager for X written in C. The goal of this project is to create a window manager that has minimal bloat but is still aestetic and usable.

Features

Installation

There is a script for Ubuntu users, all of the process is automated:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/suleyman-kaya/Ragnar/main/ubuntu_installation.sh)"

For Arch users there is also a installation script:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/cococry/Ragnar/main/install/arch_installation.sh)"

If you want to run Ragnar on your machine, clone this repo and install all dependencies

yay -S xorg xorg-xinit gcc make

Then type this command to install the WM

sudo make ragnar install

Then, in your ~/.xinitrc add:

exec ragnar

If you are using a session manager you need to add ragnar to your sessions:

sudo cp ragnar.desktop /usr/share/xsessions/ragnar.desktop

IMPORTANT

In the config.h file specify your monitor setup in order for the WM to work as intended. Also, for configuration of the WM use the config.h file.

Notes

For the best experience, i suggest to use a X compositer like picom. I am using picom pijulius because i think it has very clean animation support. You can find my picom config here

This project is in early stage and not finished. So if you find bugs or have any problems, feel free to submit an issue.

Inspiration

RagnarWM is mainly inspired by dwm. I, myself used dwm as my main window manager in the past and i really liked the minimalist style of it. But i found it really frustrating how the default dwm repository was pretty much unusable out of the box. A lot of main features are non-existend in dwm or poorly designed. That's why i was inspired to create a minimal window manager that comes with usablity out of the box. I don't think usablity and features have to suffer with minimalism. But don't get me wrong, dwm is a great window manager and i had a really nice time using it.

Usage

Default Keybindings

Keybind	Action
SUPER + Left Mouse/Middle Mouse	Select Window
SUPER + Enter	Open terminal
SUPER + W	Open Web-browser
SUPER + S	Open Application Launcher
SUPER + Q	Quit Application
SUPER + C	Quit WM
SUPER + Space	Add window to layout
SUPER + Up Arrow	Move window up in layout
SUPER + Down Arrow	Move window down in layout
SUPER + L	Increase master size in layout
SUPER + H	Decrease master size in layout
SUPER + J	Increase slave size in layout
SUPER + K	Decrease slave size in layout
SUPER + Plus	Increase gap size of windows
SUPER + Minus	Decrease gap size of windows
SUPER + F	Fullscreen selected window
SUPER + Shift + T	Set tiled master layout
SUPER + Shift + X	Set horizontal stripes layout
SUPER + Shift + M	Set vertical stripes layout
SUPER + Shift + V	Set horizontal master layout
SUPER + Shift + R	Set floating layout
SUPER + A	Cycle desktop down
SUPER + D	Cycle desktop up
SUPER + O	Cycle window one desktop down
SUPER + P	Cycle window one desktop down
SUPER + B	Cycle bar one monitor down
SUPER + N	Cycle bar one monitor up
SUPER + I	Toggle bar visibility
SUPER + Tab	Cycle through windows
SUPER + U	Toggle window decorations
SUPER + 1	Terminal scratchpad
SUPER + 2	Vim scratchpad

kalaine77/Ragnar