Skip to content
arcetera edited this page Nov 25, 2015 · 3 revisions

#the wmrc tutorial, version 1.0

welcome, and thanks for using wmrc! before getting started, make sure that you've installed wmrc, and have gotten it to successfully start; this page covers usage.

to start, wmrc is insanely modular, and that's the idea. this merely covers the defaults.

let's begin!

conventions

"super" is the windows key, and the rest is pretty much self-explanatory.

the desktop

when you start up wmrc, you'll notice that there isn't much going on. you have your bar (if enabled) and your wallpaper (if enabled), and that's about it. to open up a terminal window, press super + return. this will open st. if you don't have st installed, kill x, and edit ~/.config/sxhkd/sxhkdrc and change "st" to your choice of virtual terminal.

now you might be wondering, "do i have to open a terminal and run applications in the terminal every time?" well, no. press super + d to open dmenu. this will open up a list of commands. you can run any of them, and they're displayed in a nice list.

basic keybinds

this is more of a cheat sheet format than advanced documentation.

super + d - open dmenu

super + return - open a terminal

super + left,down,up,right - move windows

super + alt + left,down,up,right - resize windows

super + tab - switch between windows quickly

super + escape - kill the hotkey daemon (for configuration changes when you already have a terminal window open)

super + 1,2,3,4,5 - toggle groups

super + shift + 1,2,3,4,5 - assign a window to a group

super + shift + return - remove a window from all groups

super + shift + e - close a window

super + f - fullscreen a window

super + h,j,k,l - focus the closest window, left, down, up, or right of the current window

super + shift + q,w,a,s - move a window to a corner

super + shift + space - center a window

super + shift + left - tiling layout

super + shift + right - spiral layout

super + shift + up - floating layout

window management

wmrc has many window management features. for one, it has different modes and layouts. by default, wmrc will use a floating layout, however there is a bug which causes it not to indicate that it is in fact floating. run dytyl float and it will be fixed.

okay, what's this dytyl, then? dytyl is a dynamic tiling script. rather than tiling windows and keeping them strictly in a tiling layout, wmrc arranges floating windows into a tiling layout. it is a hybrid window manager, as all tiling layouts are technically floating! this gives you the freedom of simple window moving and resizing freely without the strictness of other windows, making it easier to keep multiple windows on the screen at once while still using a tiling layout.

dytyl has four layouts as of now, one which is largely unnoticed.

layouts

dytyl has four layouts:

  • default
  • full
  • spiral
  • float

with more coming soon.

first off, if you have the bar enabled, there will be an indication of what layout is enabled. if it is default, you will see "[]=" next to the red square in the bar. if it is floating, you will see "><>". if it is spiral, you will see "||=".

first off, what are these layouts?

full

the full layout can be activated by running dytyl full. it takes the existing window and makes it take up all of the screen, other than the panel and the defined gaps (which is covered in configuration). first off, there's no indication that you're in full, only default/spiral/float. why? full is merely used before activating the default or spiral layout (it isn't used in floating) as otherwise it would only take up half of the screen; that's what the master window is, which is covered in configuration. the full layout isn't meant to be activated, it's used in all other tiling layouts.

more coming soon!

Clone this wiki locally