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 X11. 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 has a small status bar which displays the text read from standard
  25 input, if written. Besides that, it displays all available tags, and the title
  26 of the focused window. It draws a 1-pixel border around windows to
  27 indicate the focus state. Unfocused windows contain a small bar in front of
  28 them displaying their tags and title.
  29 .SH OPTIONS
  30 .TP
  31 .B \-v
  32 prints version information to standard output, then exits.
  33 .SH USAGE
  34 .SS Status bar
  35 .TP
  36 .B Standard input
  37 is read and displayed in the status text area.
  38 .TP
  39 .B Button1
  40 click on a tag label views all windows with that
  41 .BR tag .
  42 .TP
  43 .B Button3
  44 click on a tag label adds/removes all windows with that
  45 .B tag
  46 to/from the view.
  47 .SS Keyboard commands
  48 .TP
  49 .B Mod1-Shift-Return
  50 Start
  51 .BR xterm (1).
  52 .TP
  53 .B Mod1-Tab
  54 Focus next
  55 .BR window .
  56 .TP
  57 .B Mod1-Shift-Tab
  58 Focus previous
  59 .BR window .
  60 .TP
  61 .B Mod1-Return
  62 Zoom current
  63 .B window
  64 to the
  65 .B master
  66 column
  67 .RB ( tiling
  68 mode only).
  69 .TP
  70 .B Mod1-m
  71 Maximize current
  72 .BR window .
  73 .TP
  74 .B Mod1-Shift-[0..n]
  75 Apply
  76 .B nth tag
  77 to current
  78 .BR window .
  79 .TP
  80 .B Mod1-Control-Shift-[0..n]
  81 Add/remove
  82 .B nth tag
  83 to/from current
  84 .BR window .
  85 .TP
  86 .B Mod1-Shift-c
  87 Close focused
  88 .B window.
  89 .TP
  90 .B Mod1-space
  91 Toggle between
  92 .B tiled
  93 and
  94 .B floating
  95 mode (affects
  96 .BR "all windows" ).
  97 .TP
  98 .B Mod1-[0..n]
  99 View all windows with
 100 .BR "tag n" .
 101 .TP
 102 .B Mod1-Control-[0..n]
 103 Add/remove all windows with
 104 .B tag n
 105 to/from the view.
 106 .TP
 107 .B Mod1-Shift-q
 108 Quit
 109 .B dwm.
 110 .SS Mouse commands
 111 .TP
 112 .B Mod1-Button1
 113 Move current
 114 .B window
 115 while dragging
 116 .RB ( floating
 117 mode only).
 118 .TP
 119 .B Mod1-Button2
 120 Zoom current
 121 .B window
 122 to the
 123 .B master
 124 column
 125 .RB ( tiling
 126 mode only).
 127 .TP
 128 .B Mod1-Button3
 129 Resize current
 130 .B window
 131 while dragging
 132 .RB ( floating
 133 mode only).
 134 .SH CUSTOMIZATION
 135 .B dwm
 136 is customized by creating a custom config.h and (re)compiling the source
 137 code. This keeps it fast, secure and simple.
 138 .SH CAVEATS
 139 The status bar displays
 140 .B broken pipe
 141 when
 142 .B dwm
 143 has been started by
 144 .BR xdm (1),
 145 because it closes standard output before executing
 146 .BR dwm .
 147 .SH SEE ALSO
 148 .BR dmenu (1)