3 awesome is an extremely fast, small, and dynamic window manager for X.
7 In order to build awesome itself, you need header files and libs of:
9 - Xlib, xcb and xcb-util (>= 0.2.1)
12 - pango and pangocairo
15 - GdkPixBuf or Imlib2 (use -DWITH_IMLIB2=ON with cmake)
16 - dbus (optional, use -DWITH_DBUS=OFF with cmake to disable)
19 In order to build the awesome man pages and documentation,
23 - docbook XSL stylesheets
26 In order to build the source code reference, you need these tools:
30 Building and Installation
31 -------------------------
32 After extracting the dist tarball, run:
36 This will create a build directory, run cmake in it and build awesome.
38 After the building done, you can type this to install:
40 make install # might need root permissions
44 Add the following line to your .xinitrc to start awesome using startx
45 or to .xsession to start awesome using gdm/kdm/xdm...:
49 In order to connect awesome to a specific display, make sure that
50 the DISPLAY environment variable is set correctly, e.g.:
52 DISPLAY=foo.bar:1 exec awesome
54 (This will start awesome on display :1 of the host foo.bar.)
58 The configuration of awesome is done by creating a $XDG_CONFIG_HOME/awesome/rc.lua file.
59 An example is provided in the sources.