.TH DWM 1 dwm-VERSION

.SH NAME

dwm \- dynamic window manager

.SH SYNOPSIS

.B dwm

.RB [ \-v ]

.SH DESCRIPTION

.B dwm

is a dynamic window manager for X11. It manages windows in tiling and floating

modes. Either mode can be applied dynamically, optimizing the environment for

the application in use and the task performed.

.P

In tiling mode windows are managed in a master and stacking column. The master

column contains the window which currently needs most attention, whereas the

stacking column contains all other windows. In floating mode windows can be

resized and moved freely. Dialog windows are always managed floating,

regardless of the mode selected.

.P

Windows are grouped by tags. Each window can be tagged with one or multiple

tags. Selecting a certain tag for viewing will display all windows with that

tag.

.P

.B dwm

has a small status bar which displays the text read from standard

input, if written. Besides that, it displays all available tags, and the title

of the focused window. It draws a 1-pixel border around windows to

indicate the focus state. Unfocused windows contain a small bar in front of

them displaying their tags and title.

.SH OPTIONS

.TP

.B \-v

prints version information to standard output, then exits.

.SH USAGE

.SS Status bar

.TP

.B Standard input

is read and displayed in the status text area.

.TP

click on a tag label focuses that

.B tag.

.TP

click on a tag label toggles that

.B tag.

.SS Keyboard commands

.TP

.B Mod1-Return

Zoom current

.B window

to the 

.B master

column.

.TP

.B Mod1-j

Focus next

.B window.

.TP

.B Mod1-k

Focus previous

.B window.

.TP

.B Mod1-m

Maximize current

.B window.

.TP

.B Mod1-[0..n]

Focus

.B nth tag.

.TP

.B Mod1-space

Toggle between

.B tiled

and

.B floating

mode (affects

.BR "all windows" ).

.TP

.B Mod1-Shift-[0..n]

Apply

.B nth tag

to current

.B window.

.TP

.B Mod1-Shift-c

Close focused

.B window.

.TP

.B Mod1-Shift-q

Quit

.B dwm.

.TP

.B Mod1-Shift-Return

Start

.B terminal.

.TP

.B Mod1-Control-[0..n]

Toggle

.B nth tag.

.TP

.B Mod1-Control-Shift-[0..n]

Append

.B nth tag

to current

.B window.

.SS Mouse commands

.TP

.B Mod1-Button1

Move current

.B window

while dragging.

.TP

.B Mod1-Button2

Zoom current

.B window

to the 

.B master

column.

.TP

.B Mod1-Button3

Resize current

.B window

while dragging.

.SH CUSTOMIZATION

.B dwm

is customized by creating a custom config.h and (re)compiling the source

code. This keeps it fast, secure and simple.

.SH CAVEATS

The status bar displays

.BR "broken pipe"

when

.B dwm

has been started by

.BR xdm (1),

because it closes standard output before executing

.B dwm.

.SH SEE ALSO

.BR dmenu (1)