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