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