README

   1 awesome
   2 =======
   3 awesome is an extremely fast, small, and dynamic window manager for X.
   4 It's based on dwm.
   5
   6 Requirements
   7 ------------
   8 In order to build awesome you need the Xlib header files, libconfuse and cairo.
   9
  10 Installation
  11 ------------
  12 Edit config.mk to match your local setup (awesome is installed into
  13 the /usr/local namespace by default).
  14
  15 Afterwards enter the following command to build and install awesome (if
  16 necessary as root):
  17
  18     make install
  19
  20 Running awesome
  21 -----------
  22 Add the following line to your .xinitrc to start awesome using startx
  23 or to .xsession to start awesome using gdm/kdm/xdm...:
  24
  25     exec awesome
  26
  27 In order to connect awesome to a specific display, make sure that
  28 the DISPLAY environment variable is set correctly, e.g.:
  29
  30     DISPLAY=foo.bar:1 exec awesome
  31
  32 (This will start awesome on display :1 of the host foo.bar.)
  33
  34 Configuration
  35 -------------
  36 The configuration of awesome is done by creating a ~/.awesomerc file.
  37 An example is provided in the sources.