dwm - dynamic window manager

This is my dwm build. Original project at suckless.org

Requirements

• Libraries
  • X11
  • XCB
  • freetype2
  • (optionally) Xinerama
  • (optionally) asound
• make
• slstatus status bar information
  • my build of slstatus

Following tools are used by default, but can be changed in config.h

• dmenu run launcher
  • my build of dmenu
  • set with the dmenucmd variable
• slock screen lock
  • my build of slock
  • set with the lockcmd variable
• picom compositor
  • set with the compcmd and comkill variables
• st terminal
  • my build of st
  • set with the termcmd variable
• firefox browser
  • set with the brwscmd variable
• spotify music player
  • set with the musccmd variable
• dwm-scripts various helper scripts
  • required for powrcmd, htopcmd, nvimcmd and chatcmd
• dmenu-scripts more helper scripts
  • required for symdmnu, grkdmnu and scrdmnu

Installation

Edit config.mk to match your local setup (dwm is installed into the /usr/local namespace by default).

Afterwards enter the following commands to build and install dwm:

make
make install # possibly as root

Running dwm

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

exec dwm

In order to connect dwm to a specific display, make sure that the DISPLAY environment variable is set correctly, e.g.:

DISPLAY=foo.bar:1 exec dwm

(This will start dwm on display :1 of the host foo.bar.)

Configuration

The configuration is done editing config.h and (re)compiling the source code. Note: Most patches won't work, since the this version is heavily modified (all diff files which have been applied are in the diffs directory)

Debugging

dwm can be built with additional debugging functionality. This build will produce additional debug logs and will use address sanitiser to check for memory errors.

MODE=DEBUG make

Note: To build in release mode explicitly use MODE=RELEASE

Note: if you want to install the debug build, the install command also needs MODE=DEBUG set, other wise it will rebuild in RELEASE mode.