# My custom DWM build.

This repository is a fork of the Dynamic Window Manager (DWM)
from suckless which contains additional patches and custom configurations.

DWM is an extremely fast, small, and dynamic window manager for X.

Version: 6.3

# Additional patches

- [**titlecolor**](https://dwm.suckless.org/patches/titlecolor/): Allows you to set a separate colour scheme for your title bar.
- [**useless gap**](https://dwm.suckless.org/patches/uselessgap/): Primarily adds 'useless' gaps around windows.

# Requirements

In order to build dwm you need the Xlib header files.

# Installation

The config.mk file was edited so that the installation path is set to ${HOME}/.local.
This can be edited to match your own local setup.

Enter the following command to build and install dwm (if
necessary as root):

```bash
$ make clean install
```

# Running dwm
Add the following line to your `${HOME}/.xinitrc` to start dwm using startx:

```bash
$ exec dwm
```

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

```bash
$ DISPLAY=foo.bar:1 exec dwm
```

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

In order to display status info in the bar, you can do something
like this in your `.xinitrc`:

```bash
while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
do
    sleep 1
done &
exec dwm
```

# Configuration

The configuration of dwm is done by creating a custom config.h
and (re)compiling the source code.

# Keybindings

The `MODKEY` is set to the Super key (Windows key).

| Key bindings              | Action                                  |
|---------------------------|-----------------------------------------|
| `MODKEY + SHIFT + RETURN` | open the st terminal                    |
| `MODKEY + b`              | toggle the bar                          |
| `MODKEY + SHIFT + b`      | open firefox                            |
| `MODKEY + SHIFT + t`      | open tmux in the st terminal            |
| `MODKEY + SHIFT + c`      | close a window                          |
| `MODKEY + SHIFT + q`      | quit dwm                                |
| `MODKEY + SHIFT + <N>`    | move the active window to workspace <N> |
| `MODKEY + <N>`            | move to workspace <N>                   |
| `MODKEY + p`              | run dmenu                              |