1.TH DWM 1 dwm-VERSION
  2.SH NAME
  3dwm \- dynamic window manager
  4.SH SYNOPSIS
  5.B dwm
  6.RB [ \-v ]
  7.SH DESCRIPTION
  8dwm is a dynamic window manager for X. It manages windows in tiling and
  9floating modes. Either mode can be applied dynamically, optimizing the
 10environment for the application in use and the task performed.
 11.P
 12In tiling mode windows are managed in a master and stacking area. The master
 13area contains the windows which currently need most attention, whereas the
 14stacking area contains all other windows. In floating mode windows can be
 15resized and moved freely. Dialog windows are always managed floating,
 16regardless of the mode applied.
 17.P
 18Windows are grouped by tags. Each window can be tagged with one or multiple
 19tags. Selecting certain tags displays all windows with these tags.
 20.P
 21dwm contains a small status bar which displays all available tags, the mode,
 22the title of the focused window, and the text read from standard input. The
 23selected tags are indicated with a different color. The tags of the focused
 24window are indicated with a filled square in the top left corner.  The tags
 25which are applied to one or more windows are indicated with an empty square in
 26the top left corner.
 27.P
 28dwm draws a small border around windows to indicate the focus state.
 29.SH OPTIONS
 30.TP
 31.B \-v
 32prints version information to standard output, then exits.
 33.SH USAGE
 34.SS Status bar
 35.TP
 36.B Standard input
 37is read and displayed in the status text area.
 38.TP
 39.B Button1
 40click on a tag label to display all windows with that tag, click on the mode
 41label toggles between tiling and floating mode.
 42.TP
 43.B Button3
 44click on a tag label adds/removes all windows with that tag to/from the view.
 45.TP
 46.B Button4
 47click on the mode label increases the number of windows in the master area (tiling mode only).
 48.TP
 49.B Button5
 50click on the mode label decreases the number of windows in the master area (tiling mode only).
 51.TP
 52.B Mod1-Button1
 53click on a tag label applies that tag to the focused window.
 54.TP
 55.B Mod1-Button3
 56click on a tag label adds/removes that tag to/from the focused window.
 57.SS Keyboard commands
 58.TP
 59.B Mod1-Shift-Return
 60Start
 61.BR xterm (1).
 62.TP
 63.B Mod1-Tab
 64Focus next window.
 65.TP
 66.B Mod1-Shift-Tab
 67Focus previous window.
 68.TP
 69.B Mod1-Return
 70Zooms/cycles current window to/from master area (tiling mode), toggles maximization of current window (floating mode).
 71.TP
 72.B Mod1-g
 73Grow master area (tiling mode only).
 74.TP
 75.B Mod1-s
 76Shrink master area (tiling mode only).
 77.TP
 78.B Mod1-i
 79Increase the number of windows in the master area (tiling mode only).
 80.TP
 81.B Mod1-d
 82Decrease the number of windows in the master area (tiling mode only).
 83.TP
 84.B Mod1-Shift-[1..n]
 85Apply
 86.RB nth
 87tag to current window.
 88.TP
 89.B Mod1-Shift-0
 90Apply all tags to current window.
 91.TP
 92.B Mod1-Control-Shift-[1..n]
 93Add/remove
 94.B nth
 95tag to/from current window.
 96.TP
 97.B Mod1-Shift-c
 98Close focused window.
 99.TP
100.B Mod1-space
101Toggle between tiling and floating mode (affects all windows).
102.TP
103.B Mod1-Shift-space
104Toggle focused window between floating and non-floating state.
105.TP
106.B Mod1-[1..n]
107View all windows with
108.BR nth
109tag.
110.TP
111.B Mod1-0
112View all windows with any tag.
113.TP
114.B Mod1-Control-[1..n]
115Add/remove all windows with
116.BR nth
117tag to/from the view.
118.TP
119.B Mod1-Shift-q
120Quit dwm.
121.SS Mouse commands
122.TP
123.B Mod1-Button1
124Move current window while dragging (floating mode only).
125.TP
126.B Mod1-Button2
127Zooms/cycles current window to/from master area (tiling mode), toggles maximization of current window (floating mode).
128.TP
129.B Mod1-Button3
130Resize current window while dragging (floating mode only).
131.SH CUSTOMIZATION
132dwm is customized by creating a custom config.h and (re)compiling the source
133code. This keeps it fast, secure and simple.
134.SH SEE ALSO
135.BR dmenu (1)
136.SH BUGS
137The status bar may display
138.BR "EOF"
139when dwm has been started by an X session manager like
140.BR xdm (1),
141because those close standard output before executing dwm.
142.P
143Java applications which use the XToolkit/XAWT backend may draw grey windows
144only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
145JDK 1.6 versions, because it assumes a reparenting window manager. As a workaround
146you can use JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or you
147can set the following environment variable (to use the older Motif
148backend instead):
149.BR AWT_TOOLKIT=MToolkit .