dwm/README.md
Dan Anglin d7583b81f0
fix: bar height patch and customisations
- Apply the bar height patch
- Update font
- Change the tag icons
- Change the master area size factor from 0.55 to 0.50
2022-05-25 04:13:38 +01:00

77 lines
2.3 KiB
Markdown

# 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 |