all repos — dwm @ 4bb89e2cb108066dc7a0d9c2c4d37bc1f5691604

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