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 a certain tag for viewing will display all windows with that
  21 tag.
  22 .P
  23 .B dwm
  24 contains a small status bar which displays all available tags, the mode, the
  25 title of the focused window, and the text read from standard input. The tags of
  26 the focused 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-Shift-[1..n]
 100 Apply
 101 .B nth tag
 102 to current
 103 .BR window .
 104 .TP
 105 .B Mod1-Control-Shift-[1..n]
 106 Add/remove
 107 .B nth tag
 108 to/from current
 109 .BR window .
 110 .TP
 111 .B Mod1-Shift-c
 112 Close focused
 113 .B window.
 114 .TP
 115 .B Mod1-space
 116 Toggle between
 117 .B tiled
 118 and
 119 .B floating
 120 mode (affects
 121 .BR "all windows" ).
 122 .TP
 123 .B Mod1-[1..n]
 124 View all windows with
 125 .BR "tag n" .
 126 .TP
 127 .B Mod1-0
 128 View all windows with any
 129 .BR "tag" .
 130 .TP
 131 .B Mod1-Control-[1..n]
 132 Add/remove all windows with
 133 .B tag n
 134 to/from the view.
 135 .TP
 136 .B Mod1-Shift-q
 137 Quit
 138 .B dwm.
 139 .SS Mouse commands
 140 .TP
 141 .B Mod1-Button1
 142 Move current
 143 .B window
 144 while dragging
 145 .RB ( floating
 146 mode only).
 147 .TP
 148 .B Mod1-Button2
 149 Zoom current
 150 .B window
 151 to the
 152 .B master
 153 column
 154 .RB ( tiling
 155 mode only).
 156 .TP
 157 .B Mod1-Button3
 158 Resize current
 159 .B window
 160 while dragging
 161 .RB ( floating
 162 mode only).
 163 .SH CUSTOMIZATION
 164 .B dwm
 165 is customized by creating a custom config.h and (re)compiling the source
 166 code. This keeps it fast, secure and simple.
 167 .SH CAVEATS
 168 The status bar may display
 169 .B broken pipe
 170 when
 171 .B dwm
 172 has been started by
 173 .BR xdm (1),
 174 because it closes standard output before executing
 175 .BR dwm .
 176 .SH SEE ALSO
 177 .BR dmenu (1)