all repos — dwm @ ee31e38dc75832a66cb0fc01bcf2f419ac96a20b

fork of suckless dynamic window manager

dwm.1 (view raw)

  1.TH DWM 1 dwm-VERSION
  2.SH NAME
  3dwm \- dynamic window manager
  4.SH SYNOPSIS
  5.B dwm
  6.RB [ \-v ]
  7.SH DESCRIPTION
  8.B dwm
  9is a dynamic window manager for X11. It manages windows in tiling and floating
 10modes. Either mode can be applied dynamically, optimizing the environment for
 11the application in use and the task performed.
 12.P
 13In tiling mode windows are managed in a master and stacking column. The master
 14column contains the window which currently needs most attention, whereas the
 15stacking column contains all other windows. In floating mode windows can be
 16resized and moved freely. Dialog windows are always managed floating,
 17regardless of the mode selected.
 18.P
 19Windows are grouped by tags. Each window can be tagged with one or multiple
 20tags. Selecting a certain tag for viewing will display all windows with that
 21tag.
 22.P
 23.B dwm
 24has a small status bar which displays the text read from standard
 25input, if written. Besides that, it displays all available tags, and the title
 26of the focused window. It draws a 1-pixel border around windows to
 27indicate the focus state. Unfocused windows contain a small bar in front of
 28them displaying their tags and title.
 29.SH OPTIONS
 30.TP
 31.B \-v
 32prints version information to standard output, then exits.
 33.SH USAGE
 34.SS Status bar
 35.TP
 36.B Standard input
 37is read and displayed in the status text area.
 38.TP
 39.B Button1
 40click on a tag label views all windows with that
 41.BR tag .
 42.TP
 43.B Button3
 44click on a tag label adds/removes all windows with that
 45.B tag
 46to/from the view.
 47.SS Keyboard commands
 48.TP
 49.B Mod1-Return
 50Zoom current
 51.B window
 52to the 
 53.B master
 54column.
 55.TP
 56.B Mod1-j
 57Focus next
 58.BR window .
 59.TP
 60.B Mod1-k
 61Focus previous
 62.BR window .
 63.TP
 64.B Mod1-m
 65Maximize current
 66.BR window .
 67.TP
 68.B Mod1-[0..n]
 69View all windows with
 70.BR "tag n" .
 71.TP
 72.B Mod1-space
 73Toggle between
 74.B tiled
 75and
 76.B floating
 77mode (affects
 78.BR "all windows" ).
 79.TP
 80.B Mod1-Shift-[0..n]
 81Apply
 82.B nth tag
 83to current
 84.BR window .
 85.TP
 86.B Mod1-Shift-c
 87Close focused
 88.B window.
 89.TP
 90.B Mod1-Shift-q
 91Quit
 92.B dwm.
 93.TP
 94.B Mod1-Shift-Return
 95Start
 96.BR terminal .
 97.TP
 98.B Mod1-Control-[0..n]
 99Add/remove all windows with
100.B tag n
101to/from the view.
102.TP
103.B Mod1-Control-Shift-[0..n]
104Add/remove
105.B nth tag
106to/from current
107.BR window .
108.SS Mouse commands
109.TP
110.B Mod1-Button1
111Move current
112.B window
113while dragging.
114.TP
115.B Mod1-Button2
116Zoom current
117.B window
118to the 
119.B master
120column.
121.TP
122.B Mod1-Button3
123Resize current
124.B window
125while dragging.
126.SH CUSTOMIZATION
127.B dwm
128is customized by creating a custom config.h and (re)compiling the source
129code. This keeps it fast, secure and simple.
130.SH CAVEATS
131The status bar displays
132.B broken pipe
133when
134.B dwm
135has been started by
136.BR xdm (1),
137because it closes standard output before executing
138.BR dwm .
139.SH SEE ALSO
140.BR dmenu (1)