dwm

my heavily-patched and customized dwm build
git clone git://git.kocotian.pl/dwm.git
Log | Files | Refs | README | LICENSE

dwm.1 (7865B)


      1 .TH DWM 1 dwm\-VERSION
      2 .SH NAME
      3 dwm \- dynamic window manager (Kacper Kocot <kocotian@kocotian.pl> fork)
      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. If you want to have simple status bar, get my build of dwmblocks
     44 with scripts from my dotfiles.
     45 .TP
     46 .B Mouse buttons
     47 click on a tag label to manage tags. Clicking in statusbar area (only on
     48 top bar) will interact with a "block". Just try it.
     49 .SS Keyboard commands
     50 Notice:
     51 .B Mod4
     52 is also called as
     53 .B Super
     54 key or
     55 .B Windows
     56 key,
     57 .B Mod4
     58 is also called as
     59 .B Alt
     60 key or
     61 .B Meta
     62 key,
     63 .TP
     64 .B Mod4\-Return
     65 Start
     66 .BR st (1).
     67 .TP
     68 .B Mod4\-d
     69 Spawn
     70 .BR dmenu (1)
     71 for launching other programs.
     72 .TP
     73 .B Mod4\-q
     74 Close focused window.
     75 .TP
     76 .B Mod4\-j
     77 Focus next window.
     78 .TP
     79 .B Mod4\-k
     80 Focus previous window.
     81 .TP
     82 .B Mod4\-Shift\-j
     83 Move window in stack (as next).
     84 .TP
     85 .B Mod4\-Shift\-k
     86 Move window in stack (as previous).
     87 .TP
     88 .B Mod4\-h
     89 Decrease master area size.
     90 .TP
     91 .B Mod4\-l
     92 Increase master area size.
     93 .TP
     94 .B Mod4\-Shift\-h
     95 Decrease cfacts area size (Window becomes larger).
     96 .TP
     97 .B Mod4\-Shift\-l
     98 Increase cfacts area size (Window becomes smaller).
     99 
    100 .TP
    101 .B Mod4\-w
    102 Open a web browser ($BROWSER).
    103 .TP
    104 .B Mod4\-Shift\-w
    105 Open a network configuration,
    106 .BR nmtui (1).
    107 .TP
    108 .B Mod4\-e
    109 Open an email client,
    110 .BR neomutt (1).
    111 .TP
    112 .B Mod4\-Shift\-e
    113 Open an address book,
    114 .BR abook (1).
    115 .TP
    116 .B Mod4\-r
    117 Sort tags.
    118 .TP
    119 .B Mod4\-Shift\-r
    120 Restore default window size (cfacts).
    121 .TP
    122 .B Mod4\-t
    123 Open system monitor,
    124 .BR gotop (1).
    125 .TP
    126 .B Mod4\-Shift\-t
    127 Open system monitor,
    128 .BR htop (1).
    129 .TP
    130 .B Mod4\-Mod1\-t
    131 Open system monitor,
    132 .BR top (1).
    133 .TP
    134 .B Mod4\-y
    135 Open youtube url in mpv from clipboard,
    136 .BR mpvclip (1).
    137 .TP
    138 .B Mod4\-Shift\-y
    139 Downloading and tagging youtube url from clipboard (ytdlclip).
    140 .TP
    141 .B Mod4\-p
    142 Pauses/plays music,
    143 .BR mpd (1),
    144 .BR mpc (1).
    145 
    146 .TP
    147 .B Mod4\-[
    148 Music 10 seconds backwards,
    149 .BR mpd (1),
    150 .BR mpc (1).
    151 
    152 .TP
    153 .B Mod4\-]
    154 Music 10 seconds forwards,
    155 .BR mpd (1),
    156 .BR mpc (1).
    157 
    158 .TP
    159 .B Mod4\-Shift\-[
    160 Music 60 seconds backwards,
    161 .BR mpd (1),
    162 .BR mpc (1).
    163 
    164 .TP
    165 .B Mod4\-Shift\-]
    166 Music 60 seconds forwards,
    167 .BR mpd (1),
    168 .BR mpc (1).
    169 
    170 
    171 .TP
    172 .B Mod4\-o
    173 Increase number of windows in master area.
    174 .TP
    175 .B Mod4\-Shift\-o
    176 Decrease number of windows in master area.
    177 .TP
    178 .B Mod4\-Mod1\-j
    179 Focus previous screen, if any.
    180 .TP
    181 .B Mod4\-Mod1\-k
    182 Focus next screen, if any.
    183 .TP
    184 .B Mod4\-Mod1\-Shift\-j
    185 Send focused window to previous screen, if any.
    186 .TP
    187 .B Mod4\-Mod1\-Shift\-k
    188 Send focused window to next screen, if any.
    189 
    190 .TP
    191 .B Mod4\-a
    192 Toggles gaps on and off.
    193 .TP
    194 .B Mod4\-Shift\-a
    195 Toggles smartgaps on and off.
    196 .TP
    197 .B Mod4\-Shift\-s
    198 Open scratchpad in vim,
    199 .BR vim (1).
    200 .TP
    201 .B Mod4\-Shift\-d
    202 Open directory editor in vim,
    203 .BR vim (1),
    204 dired.
    205 .TP
    206 .B Mod4\-f
    207 Toggles fullscreen.
    208 .TP
    209 .B Mod4\-;
    210 Open simple dmenu "additional" menu (dmenize).
    211 
    212 .TP
    213 .B Mod4\-z
    214 Iterate through window attachements.
    215 .TP
    216 .B Mod4\-Shift\-z
    217 Reset window attachements.
    218 .TP
    219 .B Mod4\-x
    220 Open calcurse calendar.
    221 .TP
    222 .B Mod4\-c
    223 Increase inner gaps.
    224 .TP
    225 .B Mod4\-v
    226 Decrease inner gaps.
    227 .TP
    228 .B Mod4\-Shift\-c
    229 Increase outer gaps.
    230 .TP
    231 .B Mod4\-Shift\-v
    232 Decrease outer gaps.
    233 .TP
    234 .B Mod4\-b
    235 Toggles bar on and off.
    236 .TP
    237 .B Mod4\-Shift\-b
    238 Sets the wallpaper.
    239 .TP
    240 .B Mod4\-n
    241 Open news reader,
    242 .BR newsboat (1).
    243 .TP
    244 .B Mod4\-Shift\-n
    245 Open VimWiki,
    246 .BR vim (1),
    247 vimwiki).
    248 .TP
    249 .B Mod4\-m
    250 Open music controller,
    251 .BR ncmpcpp (1),
    252 .BR mpd (1).
    253 .TP
    254 .B Mod4\-Shift\-m
    255 Toggle mute.
    256 .TP
    257 .B Mod4\-,
    258 Previous track,
    259 .BR mpc (1).
    260 .TP
    261 .B Mod4\-.
    262 Next track,
    263 .BR mpc (1).
    264 .TP
    265 .B Mod4\-Shift\-,
    266 Beginning of track,
    267 .BR mpc (1).
    268 
    269 .TP
    270 .B Mod4\-`
    271 Emoji list.
    272 .TP
    273 .B Mod4\-\-
    274 Decrease volume.
    275 .TP
    276 .B Mod4\-+
    277 Increase volume.
    278 .TP
    279 .B Mod4\-Shift\-\-
    280 DECREASE volume.
    281 .TP
    282 .B Mod4\-Shift\-+
    283 INCREASE volume.
    284 
    285 .TP
    286 .B Mod4\-F4
    287 Volume mixer,
    288 .BR alsamixer (1).
    289 .TP
    290 .B Mod4\-Shift\-F4
    291 Volume mixer,
    292 .BR pulsemixer (1).
    293 .TP
    294 .B Mod4\-F5
    295 Sets automatic layout.
    296 .TP
    297 .B Mod4\-Shift\-F5
    298 Sets tiling layout.
    299 .TP
    300 .B Mod4\-F6
    301 Sets vertical bottom stack layout.
    302 .TP
    303 .B Mod4\-Shift\-F6
    304 Sets horizontal bottom stack layout.
    305 .TP
    306 .B Mod4\-F7
    307 Sets monocle layout.
    308 .TP
    309 .B Mod4\-Shift\-F7
    310 Sets centered master layout.
    311 .TP
    312 .B Mod4\-F9
    313 Mounting disks.
    314 .TP
    315 .B Mod4\-F10
    316 Umounting disks.
    317 .TP
    318 .B Mod4\-F11
    319 Camera.
    320 .TP
    321 .B Mod4\-F12
    322 Toggle notifications.
    323 
    324 .B Mod4\-Space
    325 Zooms/cycles focused window to/from master area (tiled layouts only).
    326 .TP
    327 .B Mod4\-Shift\-space
    328 Toggle focused window between tiled and floating state.
    329 .TP
    330 .B Mod4\-Tab
    331 Toggles to the previously selected tags.
    332 .TP
    333 .B Mod4\-Shift\-[1..n]
    334 Apply nth tag to focused window.
    335 .TP
    336 .B Mod4\-Shift\-0
    337 Apply all tags to focused window.
    338 .TP
    339 .B Mod4\-Control\-Shift\-[1..n]
    340 Add/remove nth tag to/from focused window.
    341 .TP
    342 .B Mod4\-[1..n]
    343 View all windows with nth tag.
    344 .TP
    345 .B Mod4\-0
    346 View all windows with any tag.
    347 .TP
    348 .B Mod4\-Control\-[1..n]
    349 Add/remove all windows with nth tag to/from the view.
    350 .TP
    351 .B Mod4\-Shift\-F1
    352 Restart dwm.
    353 .TP
    354 .B Mod4\-Shift\-Control\-F1
    355 Quit dwm.
    356 .SH CUSTOMIZATION
    357 dwm is customized by creating a custom config.h and (re)compiling the source
    358 code. This keeps it fast, secure and simple.
    359 .SH SIGNALS
    360 .TP
    361 .B SIGHUP - 1
    362 Restart the dwm process.
    363 .TP
    364 .B SIGTERM - 15
    365 Cleanly terminate the dwm process.
    366 .SH SEE ALSO
    367 .BR dmenu (1),
    368 .BR st (1),
    369 .BR abook (1),
    370 .BR neomutt (1),
    371 .BR nmtui (1),
    372 .BR gotop (1),
    373 .BR htop (1),
    374 .BR top (1),
    375 .BR newsboat (1),
    376 .BR calcurse (1),
    377 .BR vim (1),
    378 .BR mpd (1),
    379 .BR mpc (1),
    380 .BR ncmpcpp (1)
    381 .SH ISSUES
    382 Java applications which use the XToolkit/XAWT backend may draw grey windows
    383 only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
    384 JDK 1.6 versions, because it assumes a reparenting window manager. Possible workarounds
    385 are using JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or setting the
    386 environment variable
    387 .BR AWT_TOOLKIT=MToolkit
    388 (to use the older Motif backend instead) or running
    389 .B xprop -root -f _NET_WM_NAME 32a -set _NET_WM_NAME LG3D
    390 or
    391 .B wmname LG3D
    392 (to pretend that a non-reparenting window manager is running that the
    393 XToolkit/XAWT backend can recognize) or when using OpenJDK setting the environment variable
    394 .BR _JAVA_AWT_WM_NONREPARENTING=1 .
    395 .SH BUGS
    396 Send all bug reports with a patch to hackers@suckless.org.