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