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 dwm is a dynamic window manager for X. It manages windows in tiled, monocle
   9 and floating layouts. Either layout can be applied dynamically, optimising the
  10 environment for the application in use and the task performed.
  11 .P
  12 In tiled layouts windows are managed in a master and stacking area. The master
  13 area on the left contains one window by default, and the stacking area on the
  14 right contains all other windows. The number of master area windows can be
  15 adjusted from zero to an arbitrary number. In monocle layout all windows are
  16 maximised to the screen size. In floating layout windows can be resized and
  17 moved freely. Dialog windows are always managed floating, regardless of the
  18 layout applied.
  19 .P
  20 Windows are grouped by tags. Each window can be tagged with one or multiple
  21 tags. Selecting certain tags displays all windows with these tags.
  22 .P
  23 Each screen contains a small status bar which displays all available tags, the
  24 layout, the title of the focused window, and the text read from the root window
  25 name property, if the screen is focused. A floating window is indicated with an
  26 empty square and a maximised floating window is indicated with a filled square
  27 before the windows title.  The selected tags are indicated with a different
  28 color. The tags of the focused window are indicated with a filled square in the
  29 top left corner.  The tags which are applied to one or more windows are
  30 indicated with an empty square in the top left corner.
  31 .P
  32 dwm draws a small border around windows to indicate the focus state.
  33 .SH OPTIONS
  34 .TP
  35 .B \-v
  36 prints version information to stderr, then exits.
  37 .SH USAGE
  38 .SS Status bar
  39 .TP
  40 .B X root window name
  41 is read and displayed in the status text area. It can be set with the
  42 .BR xsetroot (1)
  43 command.
  44 .TP
  45 .B Button1
  46 click on a tag label to display all windows with that tag, click on the layout
  47 label toggles between tiled and floating layout.
  48 .TP
  49 .B Button3
  50 click on a tag label adds/removes all windows with that tag to/from the view.
  51 .TP
  52 .B Super\-Button1
  53 click on a tag label applies that tag to the focused window.
  54 .TP
  55 .B Super\-Button3
  56 click on a tag label adds/removes that tag to/from the focused window.
  57 .SS Keyboard commands
  58 .TP
  59 .B Super\-,
  60 Focus previous screen, if any.
  61 .TP
  62 .B Super\-.
  63 Focus next screen, if any.
  64 .TP
  65 .B Super\-Shift\-,
  66 Send focused window to previous screen, if any.
  67 .TP
  68 .B Super\-Shift\-.
  69 Send focused window to next screen, if any.
  70 .TP
  71 .B Super\-t
  72 Sets tiled layout.
  73 .TP
  74 .B Super\-m
  75 Sets monocle layout.
  76 .TP
  77 .B Super\-f
  78 Sets spiral layout.
  79 .TP
  80 .B Super\-r
  81 Sets dwindle layout.
  82 .TP
  83 .B Super\-Shift\-f
  84 Toggle fullscreen for focused window.
  85 .TP
  86 .B Super\-B
  87 Toggles bar on and off.
  88 .TP
  89 .B Super\-space
  90 Toggles between current and previous layout.
  91 .TP
  92 .B Super\-Shift\-space
  93 Toggle focused window between tiled and floating state.
  94 .TP
  95 .B Super\-i
  96 Increase number of windows in master area.
  97 .TP
  98 .B Super\-d
  99 Decrease number of windows in master area.
 100 .TP
 101 .B Super\-j
 102 Focus next window.
 103 .TP
 104 .B Super\-k
 105 Focus previous window.
 106 .TP
 107 .B Super\-l
 108 Increase master area size.
 109 .TP
 110 .B Super\-h
 111 Decrease master area size.
 112 .TP
 113 .B Super\-Tab
 114 Toggles to the previously selected tags.
 115 .TP
 116 .B Super\-Shift\-[1..n]
 117 Apply nth tag to focused window.
 118 .TP
 119 .B Super\-Shift\-0
 120 Apply all tags to focused window.
 121 .TP
 122 .B Super\-Control\-Shift\-[1..n]
 123 Add/remove nth tag to/from focused window.
 124 .TP
 125 .B Super\-[1..n]
 126 View all windows with nth tag.
 127 .TP
 128 .B Super\-0
 129 View all windows with any tag.
 130 .TP
 131 .B Super\-Control\-[1..n]
 132 Add/remove all windows with nth tag to/from the view.
 133 .TP
 134 .B Super\--
 135 Increase the window size.
 136 .TP
 137 .B Super\-+
 138 Decrease the window size.
 139 .TP
 140 .B Super\-=
 141 Reset the windows size.
 142 .TP
 143 .B Super\-Shift\-q
 144 Quit dwm.
 145 .TP
 146 .B Super\-Control\-Shift\-q
 147 Restart dwm.
 148 .SS Launch and Actions
 149 .TP
 150 .B Super\-q
 151 Close focused window.
 152 .TP
 153 .B Super\-p
 154 Spawn
 155 .BR dmenu(1)
 156 for launching other programs.
 157 .TP
 158 .B Super\-Return
 159 Start
 160 .BR st(1).
 161 .TP
 162 .B Super\-L
 163 Lock screen,
 164 .BR slock.
 165 .TP
 166 .B Super\-w
 167 Web browser
 168 .BR firefox.
 169 .TP
 170 .B Super\-n
 171 Network
 172 .BR nmtui.
 173 .TP
 174 .B Super\-v
 175 View system status
 176 .BR htop.
 177 .TP
 178 .B Super\-s
 179 Sound
 180 .BR alsamixer.
 181 .SS Mouse commands
 182 .TP
 183 .B Super\-Button1
 184 Move focused window while dragging. Tiled windows will be toggled to the floating state.
 185 .TP
 186 .B Super\-Button2
 187 Toggles focused window between floating and tiled state.
 188 .TP
 189 .B Super\-Button3
 190 Resize focused window while dragging. Tiled windows will be toggled to the floating state.
 191 .SH CUSTOMIZATION
 192 dwm is customized by creating a custom config.h and (re)compiling the source
 193 code. This keeps it fast, secure and simple.
 194 .SH SIGNALS
 195 .TP
 196 .B SIGHUP - 1
 197 Restart the dwm process.
 198 .TP
 199 .B SIGTERM - 15
 200 Cleanly terminate the dwm process.
 201 .SH SEE ALSO
 202 .BR dmenu (1),
 203 .BR st (1)
 204 .SH ISSUES
 205 Java applications which use the XToolkit/XAWT backend may draw grey windows
 206 only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
 207 JDK 1.6 versions, because it assumes a reparenting window manager. Possible workarounds
 208 are using JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or setting the
 209 environment variable
 210 .BR AWT_TOOLKIT=MToolkit
 211 (to use the older Motif backend instead) or running
 212 .B xprop -root -f _NET_WM_NAME 32a -set _NET_WM_NAME LG3D
 213 or
 214 .B wmname LG3D
 215 (to pretend that a non-reparenting window manager is running that the
 216 XToolkit/XAWT backend can recognize) or when using OpenJDK setting the environment variable
 217 .BR _JAVA_AWT_WM_NONREPARENTING=1 .
 218 .SH BUGS
 219 Send all bug reports with a patch to hackers@suckless.org.