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 Button[1,2]
  40 click on a tag label focuses that
  41 .B tag.
  42 .TP
  43 .B Button3
  44 click on a tag label toggles that
  45 .B tag.
  46 .SS Keyboard commands
  47 .TP
  48 .B Mod1-Return
  49 Zoom current
  50 .B window
  51 to the
  52 .B master
  53 column.
  54 .TP
  55 .B Mod1-j
  56 Focus next
  57 .B window.
  58 .TP
  59 .B Mod1-k
  60 Focus previous
  61 .B window.
  62 .TP
  63 .B Mod1-m
  64 Maximize current
  65 .B window.
  66 .TP
  67 .B Mod1-[0..n]
  68 Focus
  69 .B nth tag.
  70 .TP
  71 .B Mod1-space
  72 Toggle between
  73 .B tiled
  74 and
  75 .B floating
  76 mode (affects
  77 .BR "all windows" ).
  78 .TP
  79 .B Mod1-Shift-[0..n]
  80 Apply
  81 .B nth tag
  82 to current
  83 .B window.
  84 .TP
  85 .B Mod1-Shift-c
  86 Close focused
  87 .B window.
  88 .TP
  89 .B Mod1-Shift-q
  90 Quit
  91 .B dwm.
  92 .TP
  93 .B Mod1-Shift-Return
  94 Start
  95 .B terminal.
  96 .TP
  97 .B Mod1-Control-[0..n]
  98 Toggle
  99 .B nth tag.
 100 .TP
 101 .B Mod1-Control-Shift-[0..n]
 102 Append
 103 .B nth tag
 104 to current
 105 .B window.
 106 .SS Mouse commands
 107 .TP
 108 .B Mod1-Button1
 109 Move current
 110 .B window
 111 while dragging.
 112 .TP
 113 .B Mod1-Button2
 114 Zoom current
 115 .B window
 116 to the
 117 .B master
 118 column.
 119 .TP
 120 .B Mod1-Button3
 121 Resize current
 122 .B window
 123 while dragging.
 124 .SH CUSTOMIZATION
 125 .B dwm
 126 is customized by creating a custom config.h and (re)compiling the source
 127 code. This keeps it fast, secure and simple.
 128 .SH CAVEATS
 129 The status bar displays
 130 .BR "broken pipe"
 131 when
 132 .B dwm
 133 has been started by
 134 .BR xdm (1),
 135 because it closes standard output before executing
 136 .B dwm.
 137 .SH SEE ALSO
 138 .BR dmenu (1)