~brown121407/dwm

b52483469bf0eb8a91194d3560e3fb73929650e2 — Alexandru-Sergiu Marton 1 year, 23 days ago 0be3ca8
Update README.
1 files changed, 38 insertions(+), 19 deletions(-)

R README => README.md
R README => README.md +38 -19
@@ 1,48 1,67 @@
dwm - dynamic window manager
============================
# dwm - dynamic window manager

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

## Requirements

In order to build dwm you need `xlib`, `freetype2`, `xinerama` and `fontconfig`.

## Applied patches

- [stacker](https://dwm.suckless.org/patches/stacker/)
- [barpadding](https://dwm.suckless.org/patches/barpadding/)
- [swallow](https://dwm.suckless.org/patches/swallow/)
- [actualfullscreen](https://dwm.suckless.org/patches/actualfullscreen/)
- [vanitygaps](https://dwm.suckless.org/patches/vanitygaps/)

## Installation

### On GNU Guix

Requirements
------------
In order to build dwm you need the Xlib header files.
You can run the `guix-install` script as it builds dwm in an environment with
all the dependencies included. It sets `PREFIX` to `~/.local` by default.

### Normal installation

Installation
------------
Edit config.mk to match your local setup (dwm is installed into
the /usr/local namespace by default).

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

    make clean install
``` sh
make clean install
```

## Running dwm

Running dwm
-----------
Add the following line to your .xinitrc to start dwm using startx:

    exec dwm
``` sh
exec dwm
```

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

    DISPLAY=foo.bar:1 exec dwm
``` sh
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:

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

## Configuration

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