blame Filippo Erik Negroni about this document

dwm is customised by editing config.h, a C language header file, and, a Make include file.

What is config.h?

config.h is a source code file which is included by dwm.c, the main dwm source code module. It serves as the configuration file for all of dwm's features, e.g., application placement, tags, and colours. A vanilla download of dwm will contain a file called config.def.h, a template you can use to create your own config.h file. To start customising dwm, simply copy config.def.h into config.h before you run make.

What is is a file included by Makefile. It allows you to configure how make is going to compile and install dwm.

How do I modify config.h?

config.h can be edited just like any other C source code file. It contains definitions of variables that are going to be used by dwm.c and therefore it is vital that the file is always up to date. The default Makefile distributed with dwm will not overwrite your customised config.h with the contents of config.def.h, even if it was updated in the latest mercurial pull. Therefore, you should always compare your customised config.h with config.def.h and make sure you include any changes to the latter in your config.h.

How do I modify can be edited just like any other text file. It contains definitions of variables that are going to be used inside Makefile. Unlike config.h, does not have a (a default Makefile). Therefore, during an update of your repository you may run into conflicts if the original is edited.

Are there any example customisations to get me started?

On the sidebar of this wiki page you will soon find links to example modifications that you may find useful to get started.