~ob/dwm

#Oscar's dwm fork

This is my personal fork of dwm (dynamic window manager). dwm is an extremely fast, small, and dynamic window manager for X.

#Requirements

In order to build dwm you need the Xlib header files.

#Installation

Edit config.mk to match your local setup (dwm is installed into the /usr/local namespace by default).

Afterwards enter the following command to build and install dwm (if necessary as root):

make clean install

#Running dwm

Add the following line to your .xinitrc to start dwm using startx:

exec dwm

In order to connect dwm to a specific display, make sure that the DISPLAY environment variable is set correctly, e.g.:

DISPLAY=foo.bar:1 exec dwm

(This will start dwm on display :1 of the host foo.bar.)

In order to display status info in the bar, you can do something like this in your .xinitrc:

while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
do
	sleep 1
done &
exec dwm

#Configuration

The configuration of dwm is done by editing the file config.h and (re)compiling the source code.

#Keyboard shortcuts

You can check the man page for dwm to learn all about it, the only thing that is not up to date are my personal shortcuts. Here they are:

DWM:

Key	Description
`j`	Focus next window.
`k`	Focus previous window.
`h`	Decrease master area size.
`l`	Increase master area size.
`,`	Focus next screen.
`.`	Focus previous screen.
`b`	Toggle status bar on/off.
`q`	Close current window.
`Space`	Make current window the main window.
`Shift`+`+` or `Shift`+`=`	Increase number of main windows.
`Shift`+`-`	Decrease number of main windows.
`Ctrl`+`q`	Quit dwm.
`Tab`	Toggles to previously selected tags.

Layouts:

Key	Description
`t`	Tiled layout (default).
`Shift`+`t`	Floating layout.
`i`	Monocle layout.
`y`	Stack on bottom layout.
`Shift`+`y`	Stack on bottom variant layout.
`u`	Deck layout.
`r`	Fibonacci layout.
`Shift`+`r`	Fibonacci variant layout.

Utilities:

Key	Description
`p`	Spawn dmenu to launch other programs.
`o`	Spawn logout menu.
`m`	Spawn mount/unmount drive menu.
`s`	Screenshot (select area).
`Shift`+`s`	Screenshot (whole screen).
`+` or `=`	Increase volume.
`-`	Decrease volume.
`Shift`+`Return`	Change keyboard layout.

Applications:

Key	Description
`Return`	Start terminal.
`f`	Start Firefox.
`e`	Start email client (Tutanota).
`c`	Start password manager (KeePassXC).
`x`	Start Signal app.

Tags (n between 1..9):

Key	Description
`n`	View all windows with `n`th tag.
`Shift`+`n`	Apply `n`th tag to focused window.
`Ctrl`+`n`	Add/remove all windows with `n`th tag to/from the view.
`Shift`+`Ctrl`+`n`	Add/remove `n`th tag to/from focused window.
`0`	View all windows with any tag.
`Shift`+`0`	Apply all tags to focused window.

The keys XF86XK_AudioRaiseVolume, XF86XK_AudioLowerVolume, XF86XK_AudioMute, XF86XK_MonBrightnessUp and XF86XK_MonBrightnessDown work as expected. The key XK_Print will take a screenshot of the selected area and Shift+XK_Print will take a screenshot of the whole screen.

A summary of the shortcuts that use letters. First row is Mod+letter and second row is Mod+Shift+letter.

┌───────┬───────┬───────┬───────┬───────┬───────┬───────┬───────┬───────┬───────┐
│Q      │W      │E      │R      │T      │Y      │U      │I      │O      │P      │
│close  │       │email  │L-fibo │L-tile │L-botto│L-deck │L-mono │session│dmenu  │
│*quit  │       │       │L-fibo2│L-float│L-bott2│       │       │       │       │
└─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┘
  │A      │S      │D      │F      │G      │H      │J      │K      │L      │
  │       │scrot  │       │Firefox│       │Big Mn │Next w.│Prev w.│Sml Mn │
  │       │full sc│       │       │       │       │       │       │       │
  └─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┬─────┴─┐
    │Z      │X      │C      │V      │B      │N      │M      │,      │.      │
    │       │Signal │Pass M │       │tgl bar│       │mount d│Prev sc│Next sc│
    │       │       │       │       │       │       │       │Send PS│Send NS│
    └───────┴───────┴───────┴───────┴───────┴───────┴───────┴───────┴───────┘

Quit (marked with *) is actually Ctrl+q.

refs