Skip to content

Latest commit

 

History

History
156 lines (124 loc) · 4.83 KB

README.md

File metadata and controls

156 lines (124 loc) · 4.83 KB
Raw

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 aesthetic and usable.

Features

  • Tiling layout
  • Multi-monitor support
  • Altering layout (Application switching, changing master size...)
  • Fullscreening windows
  • Multiple Desktops
  • Status Bar
  • Scratchpads
  • Window decorations
  • Auto Start Commands
  • Multiple Layouts
  • Full compositor Support
  • Fully Featured/Configurable Bar UI
  • Hover to select windows
  • Sys-Trais for bar

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 with your package manager.

Install Dependencies

  • git
  • make
  • gcc
  • xorg
  • xorg-xinit

Clone the repo

git clone https://github.com/cococry/Ragnar

Installing the WM is as easy as

cd Ragnar/
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

If you find bugs or have any problems with Ragnar, 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

Configuration

Configuring Ragnar is a similar process as configuring dwm. There is a config.h file with macros you can change and lists you can change to your liking. The config is written in a way, so that people without any experience in C can read it and change it.

If you changed your configuration, just use:

sudo make clean ragnar install

And Press Super + C to shutdown the WM. Then, in the tty use startx to restart the WM.

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