A fast, tiny, and dynamic window manager for X
_{Personal build with custom patches, keybindings, and scripts}

中文  ·  Install  ·  Keybindings  ·  Customization  ·  License

dwm is a dynamic window manager for X. It manages windows in tiled, monocle, and floating layouts. All layouts can be applied on the fly, adapting to the application and task at hand.

This is a personal build of dwm 6.8 with custom modifications:

• Dynamic color scheme powered by pywal16
• Media keys for brightness, volume, playback, and microphone control with Dunst notifications
• Screenshot utilities bound to function keys
• Actual fullscreen patch (proper fullscreen without the statusbar)
• kitty as the default terminal
• Super key as the primary modifier

• Xlib header files
• Xinerama (optional)
• libXft & fontconfig
• brightnessctl — for brightness scripts
• pactl (PipeWire/PulseAudio) — for volume and microphone scripts
• scrot — for screenshots
• dunst — for on-screen notifications
• playerctl — for media playback control
• dmenu — application menu backend
• j4-dmenu-desktop — desktop entry launcher
• kitty — default terminal

Edit config.mk to adjust paths for your system, then:

make clean install

If you need root privileges:

sudo make clean install

Add the following line to your .xinitrc to start dwm via startx:

exec dwm

To display dynamic status info in the bar:

while xsetroot -name "$(date)"
do
    sleep 1
done &
exec dwm

The floating layout is automatically applied to dialog windows.

Mod = Super (Windows key)

dwm/
├── dwm.c                  # Core source (2173+ lines)
├── drw.c / drw.h          # Drawing abstraction layer
├── util.c / util.h        # Utility macros & helpers
├── transient.c            # Transient window test program
├── config.def.h           # Default configuration template
├── config.h               # Active configuration (customized)
├── config.mk              # Build configuration & dependencies
├── Makefile               # Build system
├── dwm.1                  # Man page
├── dwm.png                # Icon
├── LICENSE                # MIT/X Consortium License
├── colorscheme/
│   └── colors-wal-dwm.h   # pywal16 dynamic color scheme
├── patches/
│   └── dwm-actualfullscreen-*.diff  # Fullscreen patch
├── scripts/
│   ├── audioplay.sh              # Media play/pause + notification
│   ├── brightness.sh             # Brightness control + notification
│   ├── dmenucmd.sh               # Application launcher (j4-dmenu-desktop)
│   ├── dunst_show_playerctl.sh   # Playerctl status notification
│   ├── screenshot.sh             # Fullscreen screenshot
│   ├── screenshotsel.sh          # Area screenshot
│   ├── toggle_mic.sh             # Microphone mute toggle + notification
│   └── volume.sh                 # Volume control + notification
└── wallpaper/
    ├── 1.png                                  # Custom wallpaper
    └── please_put_an_png_wallpaper_here.txt    # Wallpaper instructions

dwm is configured at compile time by editing config.h and rebuilding:

make clean install

Key areas you can tweak:

• MODKEY — Modifier key (Mod1Mask = Alt, Mod4Mask = Super)
• fonts[] — Status bar fonts
• colors[][] — Color scheme (imported from colorscheme/)
• tags[] — Tag labels
• rules[] — Per-application rules (floating, tag placement)
• keys[] — Keyboard shortcuts
• buttons[] — Mouse bindings
• layouts[] — Available layouts
• mfact — Master area width ratio (default 0.55)
• borderpx — Window border width
• resizehints — Respect size hints on tiled resize
• lockfullscreen — Force focus on fullscreen window
• refreshrate — Refresh rate for client move/resize

MIT/X Consortium License — See LICENSE for details.

_{Built with keep it simple, stupid in mind — suckless.org}