summaryrefslogtreecommitdiffstats
path: root/desktop/dwm/README.CONFIG
blob: 2114820081d96159a2171d14626d089d42161eea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
README.CONFIG for dwm

In tiled layout, windows are managed in a master and stacking area.
The master area contains the windows which currently need most
attention, whereas the stacking area contains all other windows. In
floating layout, windows can be resized and moved freely. Dialog
windows are always managed floating, regardless of the layout
selected.

Windows are grouped by tags. Each window can be tagged with one or
multiple tags. Selecting certain tags displays all windows with those
tags.

dwm contains a small status bar which displays all available tags, the
layout, the title of the focused window, and the text read from the
name of the root window. The selected tags are highlighted with a
different color, while the tags of the focused window are highlighted
with a small point.

dwm draws a small border around windows to indicate their focus state.


MULTI-MONITOR SETUP
-------------------

In multi-monitor situations, you will probably need to run some
xrandr settings. For example, considering a laptop with an external
monitor to the right of it, the following command would 'extend' the
display (rather than the default mirroring), and set the correct
resolution for both displays:

  $ xrandr --auto --output LVDS --primary --mode 1366x768 \
  --left-of VGA-0 --output VGA-0 --mode 1280x1024

To determine your optimal resolutions and display names, simply run:

  $ xrandr -q

To make this change permanent simply place the xrandr command before
'exec dwm' in your '.xinitrc'.


CUSTOMIZATION
-------------
If you wish to make changes to the default keybindings or other
settings, produce a patch against config.h.
config.h is a copy of config.def.h distributed with the source
tarball.

Place any patches in the patches/ directory before starting the
SlackBuild script. A sample patch is included that will change
the default terminal from 'st' to 'uxterm'.
This video shows one method of patch creation:

https://asciinema.org/a/30752

Here is an older video on patch creation:

https://asciinema.org/a/7886

Example:

$ cd dwm-6.1
$ cp config.def.h config.h
$ vi config.h
[make customizations]
$ diff -u config.h config.def.h > ../patches/awesome_changes.patch
$ cd ..
$ sh dwm.SlackBuild