2007-09-12 14:29:51 +02:00
|
|
|
awesome
|
|
|
|
|
=======
|
2007-09-10 12:06:54 +02:00
|
|
|
awesome is an extremely fast, small, and dynamic window manager for X.
|
2007-09-05 20:15:00 +02:00
|
|
|
It's based on dwm.
|
|
|
|
|
|
|
|
|
|
Requirements
|
|
|
|
|
------------
|
2007-12-17 06:31:27 +01:00
|
|
|
|
2007-10-10 19:59:52 +02:00
|
|
|
In order to build awesome you need the Xlib header files, libconfuse and cairo.
|
2007-12-17 06:31:27 +01:00
|
|
|
Creating the man pages also requires recent versions of the asciidoc and xmlto
|
|
|
|
|
tools.
|
2007-09-05 20:15:00 +02:00
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
------------
|
2007-09-10 12:06:54 +02:00
|
|
|
Edit config.mk to match your local setup (awesome is installed into
|
2007-09-05 20:15:00 +02:00
|
|
|
the /usr/local namespace by default).
|
|
|
|
|
|
2007-09-10 12:06:54 +02:00
|
|
|
Afterwards enter the following command to build and install awesome (if
|
2007-09-05 20:15:00 +02:00
|
|
|
necessary as root):
|
|
|
|
|
|
2007-09-12 14:29:51 +02:00
|
|
|
make install
|
2007-09-05 20:15:00 +02:00
|
|
|
|
2007-09-10 12:06:54 +02:00
|
|
|
Running awesome
|
2007-09-05 20:15:00 +02:00
|
|
|
-----------
|
2007-09-10 12:06:54 +02:00
|
|
|
Add the following line to your .xinitrc to start awesome using startx
|
|
|
|
|
or to .xsession to start awesome using gdm/kdm/xdm...:
|
2007-09-05 20:15:00 +02:00
|
|
|
|
2007-09-10 12:06:54 +02:00
|
|
|
exec awesome
|
2007-09-05 20:15:00 +02:00
|
|
|
|
2007-09-10 12:06:54 +02:00
|
|
|
In order to connect awesome to a specific display, make sure that
|
2007-09-05 20:15:00 +02:00
|
|
|
the DISPLAY environment variable is set correctly, e.g.:
|
|
|
|
|
|
2007-09-10 12:06:54 +02:00
|
|
|
DISPLAY=foo.bar:1 exec awesome
|
2007-09-05 20:15:00 +02:00
|
|
|
|
2007-09-10 12:06:54 +02:00
|
|
|
(This will start awesome on display :1 of the host foo.bar.)
|
2007-09-05 20:15:00 +02:00
|
|
|
|
|
|
|
|
Configuration
|
|
|
|
|
-------------
|
2007-09-12 14:29:51 +02:00
|
|
|
The configuration of awesome is done by creating a ~/.awesomerc file.
|
|
|
|
|
An example is provided in the sources.
|
