71 lines
1.8 KiB
Markdown
71 lines
1.8 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.
|
||
|
|
||
|
# 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).
|
||
|
|
||
|
| Keybinding | Action |
|
||
|
|---------------------------|--------|
|
||
|
| `MODKEY + SHIFT + RETURN` | open the st terminal |
|
||
|
| `MODKEY + b` | toggle the bar |
|
||
|
| `MODKEY + SHIFT + w` | open Firefox |
|
||
|
| `MODKEY + SHIFT + t` | open Tmux in the st terminal |
|
||
|
| `MODKEY + SHIFT + q` | quit DWM |
|