445 lines
12 KiB
Groff
445 lines
12 KiB
Groff
.TH DWM 1 dwm\-VERSION
|
|
.SH NAME
|
|
dwm \- dynamic window manager
|
|
.SH SYNOPSIS
|
|
.B dwm
|
|
.RB [ \-v ]
|
|
.SH DESCRIPTION
|
|
dwm is a dynamic window manager for X. It manages windows in tiled, monocle
|
|
and floating layouts. Either layout can be applied dynamically, optimising the
|
|
environment for the application in use and the task performed.
|
|
.P
|
|
In tiled layouts windows are managed in a master and stacking area. The master
|
|
area on the left contains one window by default, and the stacking area on the
|
|
right contains all other windows. The number of master area windows can be
|
|
adjusted from zero to an arbitrary number. In monocle layout all windows are
|
|
maximised to the screen size. In floating layout windows can be resized and
|
|
moved freely. Dialog windows are always managed floating, regardless of the
|
|
layout applied.
|
|
.P
|
|
Windows are grouped by tags. Each window can be tagged with one or multiple
|
|
tags. Selecting certain tags displays all windows with these tags.
|
|
.P
|
|
Each screen contains a small status bar which displays all available tags, the
|
|
layout, the title of the focused window, and the text read from the root window
|
|
name property, if the screen is focused. A floating window is indicated with an
|
|
empty square and a maximised floating window is indicated with a filled square
|
|
before the windows title. The selected tags are indicated with a different
|
|
color. The tags of the focused window are indicated with a filled square in the
|
|
top left corner. The tags which are applied to one or more windows are
|
|
indicated with an empty square in the top left corner.
|
|
.P
|
|
dwm draws a small border around windows to indicate the focus state.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-v
|
|
prints version information to stderr, then exits.
|
|
.SH USAGE
|
|
.SS Status bar
|
|
.TP
|
|
.B X root window name
|
|
is read and displayed in the status text area. It can be set with the
|
|
.BR xsetroot (1)
|
|
command.
|
|
.TP
|
|
.B Button1
|
|
click on a tag label to display all windows with that tag, click on the layout
|
|
label toggles between tiled and floating layout.
|
|
.TP
|
|
.B Button3
|
|
click on a tag label adds/removes all windows with that tag to/from the view.
|
|
.TP
|
|
.B Mod1\-Button1
|
|
click on a tag label applies that tag to the focused window.
|
|
.TP
|
|
.B Mod1\-Button3
|
|
click on a tag label adds/removes that tag to/from the focused window.
|
|
.SS Keyboard commands
|
|
.TP
|
|
.B Mod1\-Shift\-Return
|
|
Start
|
|
.BR st(1).
|
|
.TP
|
|
.B Mod1\-p
|
|
Spawn
|
|
.BR dmenu(1)
|
|
for launching other programs.
|
|
.TP
|
|
.B Mod1\-,
|
|
Focus previous screen, if any.
|
|
.TP
|
|
.B Mod1\-.
|
|
Focus next screen, if any.
|
|
.TP
|
|
.B Mod1\-Shift\-,
|
|
Send focused window to previous screen, if any.
|
|
.TP
|
|
.B Mod1\-Shift\-.
|
|
Send focused window to next screen, if any.
|
|
.TP
|
|
.B Mod1\-b
|
|
Toggles bar on and off.
|
|
.TP
|
|
.B Mod1\-t
|
|
Sets tiled layout.
|
|
.TP
|
|
.B Mod1\-f
|
|
Sets floating layout.
|
|
.TP
|
|
.B Mod1\-m
|
|
Sets monocle layout.
|
|
.TP
|
|
.B Mod1\-space
|
|
Toggles between current and previous layout.
|
|
.TP
|
|
.B Mod1\-j
|
|
Focus next window.
|
|
.TP
|
|
.B Mod1\-k
|
|
Focus previous window.
|
|
.TP
|
|
.B Mod1\-i
|
|
Increase number of windows in master area.
|
|
.TP
|
|
.B Mod1\-d
|
|
Decrease number of windows in master area.
|
|
.TP
|
|
.B Mod1\-l
|
|
Increase master area size.
|
|
.TP
|
|
.B Mod1\-h
|
|
Decrease master area size.
|
|
.TP
|
|
.B Mod1\-Return
|
|
Zooms/cycles focused window to/from master area (tiled layouts only).
|
|
.TP
|
|
.B Mod1\-Shift\-c
|
|
Close focused window.
|
|
.TP
|
|
.B Mod1\-Shift\-f
|
|
Toggle fullscreen for focused window.
|
|
.TP
|
|
.B Mod1\-Shift\-space
|
|
Toggle focused window between tiled and floating state.
|
|
.TP
|
|
.B Mod1\-Tab
|
|
Toggles to the previously selected tags.
|
|
.TP
|
|
.B Mod1\-Shift\-[1..n]
|
|
Apply nth tag to focused window.
|
|
.TP
|
|
.B Mod1\-Shift\-0
|
|
Apply all tags to focused window.
|
|
.TP
|
|
.B Mod1\-Control\-Shift\-[1..n]
|
|
Add/remove nth tag to/from focused window.
|
|
.TP
|
|
.B Mod1\-[1..n]
|
|
View all windows with nth tag.
|
|
.TP
|
|
.B Mod1\-0
|
|
View all windows with any tag.
|
|
.TP
|
|
.B Mod1\-Control\-[1..n]
|
|
Add/remove all windows with nth tag to/from the view.
|
|
.TP
|
|
.B Mod1\-Shift\-q
|
|
Quit dwm.
|
|
.SS Mouse commands
|
|
.TP
|
|
.B Mod1\-Button1
|
|
Move focused window while dragging. Tiled windows will be toggled to the floating state.
|
|
.TP
|
|
.B Mod1\-Button2
|
|
Toggles focused window between floating and tiled state.
|
|
.TP
|
|
.B Mod1\-Button3
|
|
Resize focused window while dragging. Tiled windows will be toggled to the floating state.
|
|
.SH CUSTOMIZATION
|
|
dwm is customized by creating a custom config.h and (re)compiling the source
|
|
code. This keeps it fast, secure and simple.
|
|
.SH SEE ALSO
|
|
.BR dmenu (1),
|
|
.BR st (1)
|
|
.SH ISSUES
|
|
Java applications which use the XToolkit/XAWT backend may draw grey windows
|
|
only. The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and early
|
|
JDK 1.6 versions, because it assumes a reparenting window manager. Possible workarounds
|
|
are using JDK 1.4 (which doesn't contain the XToolkit/XAWT backend) or setting the
|
|
environment variable
|
|
.BR AWT_TOOLKIT=MToolkit
|
|
(to use the older Motif backend instead) or running
|
|
.B xprop -root -f _NET_WM_NAME 32a -set _NET_WM_NAME LG3D
|
|
or
|
|
.B wmname LG3D
|
|
(to pretend that a non-reparenting window manager is running that the
|
|
XToolkit/XAWT backend can recognize) or when using OpenJDK setting the environment variable
|
|
.BR _JAVA_AWT_WM_NONREPARENTING=1 .
|
|
.SH BUGS
|
|
Send all bug reports with a patch to hackers@suckless.org.
|
|
.SH NAME
|
|
.PP
|
|
dwm - dynamic window manager
|
|
.SH SYNOPSIS
|
|
.PP
|
|
\f[B]dwm\f[R] [\f[B]-v\f[R]]
|
|
.SH DESCRIPTION
|
|
.PP
|
|
dwm is a dynamic window manager for X.
|
|
It manages windows in tiled, monocle and floating layouts.
|
|
Either layout can be applied dynamically, optimising the environment for
|
|
the application in use and the task performed.
|
|
.PP
|
|
In tiled layouts windows are managed in a master and stacking area.
|
|
The master area on the left contains one window by default, and the
|
|
stacking area on the right contains all other windows.
|
|
The number of master area windows can be adjusted from zero to an
|
|
arbitrary number.
|
|
In monocle layout all windows are maximised to the screen size.
|
|
In floating layout windows can be resized and moved freely.
|
|
Dialog windows are always managed floating, regardless of the layout
|
|
applied.
|
|
.PP
|
|
Windows are grouped by tags.
|
|
Each window can be tagged with one or multiple tags.
|
|
Selecting certain tags displays all windows with these tags.
|
|
.PP
|
|
Each screen contains a small status bar which displays all available
|
|
tags, the layout, the title of the focused window, and the text read
|
|
from the root window name property, if the screen is focused.
|
|
A floating window is indicated with an empty square and a maximised
|
|
floating window is indicated with a filled square before the windows
|
|
title.
|
|
The selected tags are indicated with a different color.
|
|
The tags of the focused window are indicated with a filled square in the
|
|
top left corner.
|
|
The tags which are applied to one or more windows are indicated with an
|
|
empty square in the top left corner.
|
|
.PP
|
|
dwm draws a small border around windows to indicate the focus state.
|
|
.SH OPTIONS
|
|
.TP
|
|
\f[B]-v\f[R]
|
|
prints version information to stderr, then exits.
|
|
.SH USAGE
|
|
.SS Status bar
|
|
.TP
|
|
\f[B]X root window name\f[R]
|
|
is read and displayed in the status text area.
|
|
It can be set with the \f[B]xsetroot\f[R](1) command.
|
|
.TP
|
|
\f[B]Button1\f[R]
|
|
click on a tag label to display all windows with that tag, click on the
|
|
layout label toggles between tiled and floating layout.
|
|
.TP
|
|
\f[B]Button3\f[R]
|
|
click on a tag label adds/removes all windows with that tag to/from the
|
|
view.
|
|
.TP
|
|
\f[B]Mod1-Button1\f[R]
|
|
click on a tag label applies that tag to the focused window.
|
|
.TP
|
|
\f[B]Mod1-Button3\f[R]
|
|
click on a tag label adds/removes that tag to/from the focused window.
|
|
.SS Keyboard commands
|
|
.TP
|
|
\f[B]Mod1-Shift-Return\f[R]
|
|
Start \f[B]st(1).\f[R]
|
|
.TP
|
|
\f[B]Mod1-Shift-t\f[R]
|
|
Start \f[B]st(1)\f[R] via \f[B]tabbed(1).\f[R]
|
|
.TP
|
|
\f[B]Mod4-s\f[R]
|
|
Spawn \f[B]spmenu(1)\f[R] for launching other programs.
|
|
.TP
|
|
\f[B]Mod4-Shift-s\f[R]
|
|
Spawn \f[B]spmenu(1)\f[R] for launching specific programs (mimics
|
|
\f[B]dmenu(1)\f[R] behavior).
|
|
.TP
|
|
\f[B]Mod4-Mod1-s\f[R]
|
|
Spawn \f[B]dmenu(1)\f[R] if \f[B]spmenu(1)\f[R] isn\[cq]t installed or
|
|
if preferred.
|
|
.TP
|
|
\f[B]Mod4-Print\f[R]
|
|
Screenshot dwm via \f[B]maim(1)\f[R], saving it to \[ti]/Pictures.
|
|
.TP
|
|
\f[B]Mod4-Shift-Print\f[R]
|
|
Screenshot with the ability to copy it on the clipboard, via the
|
|
screenshot-spmenu script for \f[B]spmenu(1).\f[R]
|
|
.TP
|
|
\f[B]Mod4-Mod1-Print\f[R]
|
|
Partial screenshot via the screenshot-spmenu script for
|
|
\f[B]spmenu(1).\f[R]
|
|
.TP
|
|
\f[B]Mod4-v\f[R]
|
|
View clipboard contents using the clipmenu-spmenu script for
|
|
\f[B]spmenu(1).\f[R]
|
|
.TP
|
|
\f[B]Mod4-p\f[R]
|
|
Search 1337x via the pirokit-spmenu script for \f[B]spmenu(1).\f[R]
|
|
.TP
|
|
\f[B]Mod4-w\f[R]
|
|
Set the wallpaper using xwallpaper via the wallpaper-spmenu script for
|
|
\f[B]spmenu(1).\f[R]
|
|
.TP
|
|
\f[B]Mod4-e\f[R]
|
|
Launch a file manager (by default, Dolphin).
|
|
.TP
|
|
\f[B]Mod1-Shift-i\f[R]
|
|
Launch a browser (by default, Firefox).
|
|
.TP
|
|
\f[B]Mod1-n\f[R]
|
|
Switch to the next tag, if any.
|
|
.TP
|
|
\f[B]Mod1-b\f[R]
|
|
Switch to the previous tag, if any.
|
|
.TP
|
|
\f[B]Mod1-,\f[R]
|
|
Focus previous screen, if any.
|
|
.TP
|
|
\f[B]Mod1-.\f[R]
|
|
Focus next screen, if any.
|
|
.TP
|
|
\f[B]Mod1-Shift-,\f[R]
|
|
Send focused window to previous screen, if any.
|
|
.TP
|
|
\f[B]Mod1-Shift-.\f[R]
|
|
Send focused window to next screen, if any.
|
|
.TP
|
|
\f[B]Mod1-Shift-b\f[R]
|
|
Toggles bar on and off.
|
|
.TP
|
|
\f[B]Mod1-t\f[R]
|
|
Sets tiled layout.
|
|
.TP
|
|
\f[B]Mod1-f\f[R]
|
|
Sets floating layout.
|
|
.TP
|
|
\f[B]Mod1-m\f[R]
|
|
Sets monocle layout.
|
|
.TP
|
|
\f[B]Mod1-g\f[R]
|
|
Sets grid layout.
|
|
.TP
|
|
\f[B]Mod1-Shift-d\f[R]
|
|
Sets horizontal grid layout.
|
|
.TP
|
|
\f[B]Mod-Shift-g\f[R]
|
|
Sets gapless grid layout.
|
|
.TP
|
|
\f[B]Mod1-space\f[R]
|
|
Toggles between current and previous layout.
|
|
.TP
|
|
\f[B]Mod1-j\f[R]
|
|
Focus next window.
|
|
.TP
|
|
\f[B]Mod1-k\f[R]
|
|
Focus previous window.
|
|
.TP
|
|
\f[B]Mod1-i\f[R]
|
|
Increase number of windows in master area.
|
|
.TP
|
|
\f[B]Mod1-d\f[R]
|
|
Decrease number of windows in master area.
|
|
.TP
|
|
\f[B]Mod1-l\f[R]
|
|
Increase master area size.
|
|
.TP
|
|
\f[B]Mod1-h\f[R]
|
|
Decrease master area size.
|
|
.TP
|
|
\f[B]Mod1-Return\f[R]
|
|
Zooms/cycles focused window to/from master area (tiled layouts only).
|
|
.TP
|
|
\f[B]Mod1-Shift-x\f[R]
|
|
Close focused window.
|
|
.TP
|
|
\f[B]Mod1-Shift-f\f[R]
|
|
Toggle fullscreen for focused window.
|
|
.TP
|
|
\f[B]Mod1-Shift-space\f[R]
|
|
Toggle focused window between tiled and floating state.
|
|
.TP
|
|
\f[B]Mod1-q\f[R]
|
|
Toggles to the previously selected tags.
|
|
.TP
|
|
\f[B]Mod1-Shift-[1..n]\f[R]
|
|
Apply nth tag to focused window.
|
|
.TP
|
|
\f[B]Mod1-Shift-0\f[R]
|
|
Apply all tags to focused window.
|
|
.TP
|
|
\f[B]Mod1-Control-Shift-[1..n]\f[R]
|
|
Add/remove nth tag to/from focused window.
|
|
.TP
|
|
\f[B]Mod1-[1..n]\f[R]
|
|
View all windows with nth tag.
|
|
.TP
|
|
\f[B]Mod1-0\f[R]
|
|
View all windows with any tag.
|
|
.TP
|
|
\f[B]Mod1-Control-[1..n]\f[R]
|
|
Add/remove all windows with nth tag to/from the view.
|
|
.TP
|
|
\f[B]Mod1-Tab\f[R]
|
|
Switch between active windows.
|
|
.TP
|
|
\f[B]Ctrl-Shift-s\f[R]
|
|
Show hidden windows.
|
|
.TP
|
|
\f[B]Ctrl-Shift-h\f[R]
|
|
Hide windows.
|
|
.TP
|
|
\f[B]Mod1-Shift-j\f[R]
|
|
Focus to next hidden window.
|
|
.TP
|
|
\f[B]Mod1-Shift-k\f[R]
|
|
Focus to previous hidden window.
|
|
.TP
|
|
\f[B]Mod1-Shift-q\f[R]
|
|
Quit dwm.
|
|
.SS Mouse commands
|
|
.TP
|
|
\f[B]Mod1-Button1\f[R]
|
|
Move focused window while dragging.
|
|
Tiled windows will be toggled to the floating state.
|
|
.TP
|
|
\f[B]Mod1-Button2\f[R]
|
|
Toggles focused window between floating and tiled state.
|
|
.TP
|
|
\f[B]Mod1-Button3\f[R]
|
|
Resize focused window while dragging.
|
|
Tiled windows will be toggled to the floating state.
|
|
.TP
|
|
\f[B]Button1- Start\f[R]
|
|
Spawn \f[B]spmenu(1)\f[R] for launching other programs.
|
|
.TP
|
|
\f[B]Button1-(program)\f[R]
|
|
Show/hide a window.
|
|
.SH CUSTOMIZATION
|
|
.PP
|
|
dwm is customized by creating a custom config.h and (re)compiling the
|
|
source code.
|
|
This keeps it fast, secure and simple.
|
|
.SH SEE ALSO
|
|
.PP
|
|
\f[B]dmenu\f[R](1), \f[B]st\f[R](1), \f[B]spmenu(1)\f[R]
|
|
.SH ISSUES
|
|
.PP
|
|
Java applications which use the XToolkit/XAWT backend may draw grey
|
|
windows only.
|
|
The XToolkit/XAWT backend breaks ICCCM-compliance in recent JDK 1.5 and
|
|
early JDK 1.6 versions, because it assumes a reparenting window manager.
|
|
Possible workarounds are using JDK 1.4 (which doesn\[aq]t contain the
|
|
XToolkit/XAWT backend) or setting the environment variable
|
|
\f[B]AWT_TOOLKIT=MToolkit\f[R] (to use the older Motif backend instead)
|
|
or running \f[B]xprop -root -f _NET_WM_NAME 32a -set _NET_WM_NAME
|
|
LG3D\f[R] or \f[B]wmname LG3D\f[R] (to pretend that a non-reparenting
|
|
window manager is running that the XToolkit/XAWT backend can recognize)
|
|
or when using OpenJDK setting the environment variable
|
|
\f[B]_JAVA_AWT_WM_NONREPARENTING=1\f[R].
|
|
.SH BUGS
|
|
.PP
|
|
Send all bug reports with a patch to hackers\[at]suckless.org,
|
|
lucas0021a\[at]outlook.com, via GitHub, GitLab or BitBucket.
|