README

   1 JasonWoof's fork of dwm - dynamic window manager
   2 ================================================
   3 dwm is an extremely fast, small, and dynamic window manager for X.
   4
   5 JasonWoof's modifications include:
   6
   7 1.      A new layout that's kinda like deck, but there's a little space above and
   8         below the main slave window where you can see (a little bit of) the other
   9         slave windows.
  10
  11 2.      When you've got only 1 window in a workspace: by default, it is in the
  12         master area. A new tag/attribute is used to specify windows that should use
  13         all available space when alone. This results in fewer window resizes, and
  14         is nice for applications which are usually not so nice when they're huge
  15         (eg firefox, mutt).
  16
  17 3.      _NET_WM_OPACITY is set. Run xcompmgr or the like, so you can see which
  18         window has focus. (Non-zero width borders are probably broken in this fork)
  19
  20 4.      Terminals are spawned with environmental variable containing the current
  21         workspace number. This can be used to eg have separate shell history per
  22         workspace, and/or make terminals stay in their correct workspaces accross
  23         dwm restarts.
  24
  25
  26 Requirements
  27 ------------
  28 In order to build dwm you need the Xlib header files.
  29
  30
  31 Installation
  32 ------------
  33 Edit config.mk to match your local setup (dwm is installed into
  34 the /usr/local namespace by default).
  35
  36 Afterwards enter the following command to build and install dwm (if
  37 necessary as root):
  38
  39     make clean install
  40
  41 If you are going to use the default bluegray color scheme it is highly
  42 recommended to also install the bluegray files shipped in the dextra package.
  43
  44
  45 Running dwm
  46 -----------
  47 Add the following line to your .xinitrc to start dwm using startx:
  48
  49     exec dwm
  50
  51 In order to connect dwm to a specific display, make sure that
  52 the DISPLAY environment variable is set correctly, e.g.:
  53
  54     DISPLAY=foo.bar:1 exec dwm
  55
  56 (This will start dwm on display :1 of the host foo.bar.)
  57
  58 In order to display status info in the bar, you can do something
  59 like this in your .xinitrc:
  60
  61     while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
  62     do
  63         sleep 1
  64     done &
  65     exec dwm
  66
  67
  68 Configuration
  69 -------------
  70 The configuration of dwm is done by creating a custom config.h
  71 and (re)compiling the source code.