dwm.1

.TH DWM 1 dwm\-VERSION
.SH NAME
dwm \- dynamic window manager (scroll fork)
.SH SYNOPSIS
.B dwm
.RB [ \-v ]
.SH DESCRIPTION
dwm is a dynamic window manager for X. This fork replaces the master/stack
layout with a horizontal scroll layout and a built-in status bar.
.P
Windows are grouped by nine tags (1-9). Each window belongs to exactly one tag,
and each monitor shows one tag at a time. The scroll layout arranges tiled
clients in a horizontal strip for the active tag; floating clients stay above.
Focus the next/previous tiled client with Mod1\-j / Mod1\-k (floating clients
are skipped) or pan with the mouse wheel on the tab/title area. When only one
tiled client exists, Mod1\-space toggles between a full fill and a centered 3:2
window. The alternate layout is floating.
.P
The bar shows a super icon, the focused window class (or fallback text), the tag
list, the layout glyph, per-client tabs for the current tag, status widgets
(notify, battery, clock, net, CPU, per-core load, temperature, memory, menu),
and a scaled system tray. dwm draws and updates the status itself; xsetroot is
not used.
.SH OPTIONS
.TP
.B \-v
prints version information to stderr, then exits.
.SH USAGE
.SS Status bar
.TP
.B Super icon
Button1 toggles its highlight.
.TP
.B Window class label
Button1 spawns rofi, Button3 spawns the terminal.
.TP
.B Tag labels
Button1 shows the tag; Mod1\-Button1 moves the focused client to that tag.
.TP
.B Layout symbol
Button1 toggles between scroll and floating.
.TP
.B Client tabs/title
Button1 focuses the client; Button4/5 pan the scroll layout.
.TP
.B Status widgets
Notify: Button1 pops the last five notifications, Button3 clears, Button4 pops
one, Button5 closes.
.br
Battery: display only.
.br
Clock: display only (12h with AM/PM).
.br
Net: Button1 cycles interfaces defined in interface_name and shows a
notification.
.br
CPU graph: Button1/5 volume down 5%/1%; Button3 volume up 5%; Button4 volume up
1%; Button2 toggles mute.
.br
Per-core: Button1 brightness -5%; Button3 brightness +5%; Button4 brightness
+1%; Button5 brightness -1%.
.br
Temp: Button1 cycles thermal zones and shows a notification.
.br
Mem: Button1 opens mate-system-monitor.
.br
More: Button1 runs script-menu.sh.
.TP
.B System tray
Icons are scaled to a fraction of the bar height and follow the selected monitor
unless pinning is configured.
.SS Keyboard commands
.TP
.B Mod1\-p
Spawn rofi.
.TP
.B Mod1\-Shift\-Return
Spawn the terminal (nixGLIntel + kitty).
.TP
.B Mod1\-b
Toggle bar visibility.
.TP
.B Mod1\-Tab
View tag 1.
.TP
.B Mod1\-Shift\-c
Close focused window.
.TP
.B Mod1\-h
Decrease the focused client's mfact value.
.TP
.B Mod1\-l
Increase the focused client's mfact value.
.TP
.B Mod1\-j
Focus next tiled client in the current tag (skips floats).
.TP
.B Mod1\-k
Focus previous tiled client in the current tag (skips floats).
.TP
.B Mod1\-Shift\-j
Focus next tiled client and ensure it is visible.
.TP
.B Mod1\-Shift\-k
Focus previous tiled client and ensure it is visible.
.TP
.B Mod1\-Return
Ensure the focused client is scrolled into view.
.TP
.B Mod1\-space
Toggle single-window fill mode (scroll layout).
.TP
.B Mod1\-Shift\-space
Toggle floating state of focused window.
.TP
.B Mod1\-[1..9]
View nth tag.
.TP
.B Mod1\-Shift\-[1..9]
Apply nth tag to focused window.
.TP
.B Mod1\-Shift\-q
Quit dwm.
.SS Mouse commands
.TP
.B Mod1\-Button1
Move focused floating window.
.TP
.B Mod1\-Button2
Toggle floating state.
.TP
.B Mod1\-Button3
Resize focused floating window.
.SH CUSTOMIZATION
dwm is customized by creating a custom config.h and recompiling. Colors, fonts,
helper commands, gaps, tray sizing, interface names and virtual monitor splits
are controlled in config.def.h.
.SH SEE ALSO
.BR dmenu (1),
.BR st (1)
.SH BUGS
Send all bug reports with a patch to hackers@suckless.org.