dwm.1

   1 .TH DWM 1 dwm-VERSION
   2 .SH NAME
   3 dwm \- dynamic window manager
   4 .SH SYNOPSIS
   5 .B dwm
   6 .RB [ \-v ]
   7 .SH DESCRIPTION
   8 .B dwm
   9 is a dynamic window manager for X. It manages windows in tiling and floating
  10 modes. Either mode can be applied dynamically, optimizing the environment for
  11 the application in use and the task performed.
  12 .P
  13 In tiling mode windows are managed in a master and stacking column. The master
  14 column contains the window which currently needs most attention, whereas the
  15 stacking column contains all other windows. In floating mode windows can be
  16 resized and moved freely. Dialog windows are always managed floating,
  17 regardless of the mode selected.
  18 .P
  19 Windows are grouped by tags. Each window can be tagged with one or multiple
  20 tags. Selecting certain tags for viewing will display all windows with that tag.
  21 .P
  22 .B dwm
  23 contains a small status bar which displays all available tags, the mode, the
  24 title of the focused window, and the text read from standard input. The
  25 selected tags are highlighted with a different color, the tags of the focused
  26 window are highlighted with a small point.
  27 .P
  28 .B dwm
  29 draws a 1-pixel border around windows to indicate the focus state.
  30 Unfocused windows contain a small bar in front of them displaying their title.
  31 .SH OPTIONS
  32 .TP
  33 .B \-v
  34 prints version information to standard output, then exits.
  35 .SH USAGE
  36 .SS Status bar
  37 .TP
  38 .B Standard input
  39 is read and displayed in the status text area.
  40 .TP
  41 .B Button1
  42 click on a tag label views all windows with that
  43 .BR tag ,
  44 click on the mode label toggles between
  45 .B tiled
  46 and
  47 .B floating
  48 mode.
  49 .TP
  50 .B Button3
  51 click on a tag label adds/removes all windows with that
  52 .B tag
  53 to/from the view.
  54 .TP
  55 .B Mod1-Button1
  56 click on a tag label applies that
  57 .B tag
  58 to the focused
  59 .BR window .
  60 .TP
  61 .B Mod1-Button3
  62 click on a tag label adds/removes that
  63 .B tag
  64 to/from the focused
  65 .BR window .
  66 .SS Keyboard commands
  67 .TP
  68 .B Mod1-Shift-Return
  69 Start
  70 .BR xterm (1).
  71 .TP
  72 .B Mod1-Tab
  73 Focus next
  74 .BR window .
  75 .TP
  76 .B Mod1-Shift-Tab
  77 Focus previous
  78 .BR window .
  79 .TP
  80 .B Mod1-Return
  81 Zoom current
  82 .B window
  83 to the
  84 .B master
  85 column
  86 .RB ( tiling
  87 mode only).
  88 .TP
  89 .B Mod1-m
  90 Maximize current
  91 .BR window .
  92 .TP
  93 .B Mod1-g
  94 Grow current
  95 .BR column
  96 .RB ( tiling
  97 mode only).
  98 .TP
  99 .B Mod1-s
 100 Shrink current
 101 .BR column
 102 .RB ( tiling
 103 mode only).
 104 .TP
 105 .B Mod1-Shift-[1..n]
 106 Apply
 107 .B nth tag
 108 to current
 109 .BR window .
 110 .TP
 111 .B Mod1-Control-Shift-[1..n]
 112 Add/remove
 113 .B nth tag
 114 to/from current
 115 .BR window .
 116 .TP
 117 .B Mod1-Shift-c
 118 Close focused
 119 .B window.
 120 .TP
 121 .B Mod1-space
 122 Toggle between
 123 .B tiled
 124 and
 125 .B floating
 126 mode (affects
 127 .BR "all windows" ).
 128 .TP
 129 .B Mod1-[1..n]
 130 View all windows with
 131 .BR "tag n" .
 132 .TP
 133 .B Mod1-0
 134 View all windows with any
 135 .BR "tag" .
 136 .TP
 137 .B Mod1-Control-[1..n]
 138 Add/remove all windows with
 139 .B tag n
 140 to/from the view.
 141 .TP
 142 .B Mod1-Shift-q
 143 Quit
 144 .B dwm.
 145 .SS Mouse commands
 146 .TP
 147 .B Mod1-Button1
 148 Move current
 149 .B window
 150 while dragging
 151 .RB ( floating
 152 mode only).
 153 .TP
 154 .B Mod1-Button2
 155 Zoom current
 156 .B window
 157 to the
 158 .B master
 159 column
 160 .RB ( tiling
 161 mode only).
 162 .TP
 163 .B Mod1-Button3
 164 Resize current
 165 .B window
 166 while dragging
 167 .RB ( floating
 168 mode only).
 169 .SH CUSTOMIZATION
 170 .B dwm
 171 is customized by creating a custom config.h and (re)compiling the source
 172 code. This keeps it fast, secure and simple.
 173 .SH CAVEATS
 174 The status bar may display
 175 .B broken pipe
 176 when
 177 .B dwm
 178 has been started by
 179 .BR xdm (1),
 180 because it closes standard output before executing
 181 .BR dwm .
 182 .SH SEE ALSO
 183 .BR dmenu (1)