Go to file
Julien Danjou cb3230bf21 fix typo on space 2007-10-09 21:44:27 +02:00
layouts bugfix: wrong column X coord in multi-columns mode 2007-10-09 10:45:27 +02:00
.gitignore add .gitignore for *.o and awesome binary 2007-10-02 18:45:59 +02:00
AUTHORS cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
LICENSE chance license to GPLv2 2007-09-12 14:29:51 +02:00
Makefile add common.h to dist target 2007-09-26 11:28:16 +02:00
README switch to libconfuse instead of libconfig 2007-10-08 18:45:05 +02:00
awesome.1 update manpage 2007-09-18 23:22:39 +02:00
awesome.c bugfix: don't do stuff RootWindow() with non existent screen (Xinerama) 2007-10-03 20:58:00 +02:00
awesome.doxygen set version to devel 2007-09-18 23:30:10 +02:00
awesome.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
awesomerc fix typo on space 2007-10-09 21:44:27 +02:00
client.c bugfix: don't do stuff RootWindow() with non existent screen (Xinerama) 2007-10-03 20:58:00 +02:00
client.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
common.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
config.c bugfix: print layout symbol in status bar 2007-10-09 17:31:44 +02:00
config.h switch to libconfuse instead of libconfig 2007-10-08 18:45:05 +02:00
config.mk switch to libconfuse instead of libconfig 2007-10-08 18:45:05 +02:00
draw.c avoid DC in drawsquare() 2007-10-09 21:43:26 +02:00
draw.h avoid DC in drawsquare() 2007-10-09 21:43:26 +02:00
event.c new feature: mouse wheel on layout symbol switch to prev/next 2007-10-05 13:51:19 +02:00
event.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
layout.c new feature: add option to center pointer on focused client 2007-10-08 14:26:43 +02:00
layout.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
screen.c fix typo 2007-10-05 17:02:59 +02:00
screen.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
statusbar.c avoid DC in drawsquare() 2007-10-09 21:43:26 +02:00
statusbar.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
tag.c cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
tag.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
util.c cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00
util.h cosmetic: remove lines with empty spaces at end 2007-10-03 17:26:14 +02:00

README

awesome
=======
awesome is an extremely fast, small, and dynamic window manager for X.
It's based on dwm.

Requirements
------------
In order to build awesome you need the Xlib header files and libconfuse.

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

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

    make install

Running awesome
-----------
Add the following line to your .xinitrc to start awesome using startx
or to .xsession to start awesome using gdm/kdm/xdm...:

    exec awesome

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

    DISPLAY=foo.bar:1 exec awesome

(This will start awesome 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 true
    do
        echo `date` `uptime | sed 's/.*,//'`
        sleep 1
    done | awesome


Configuration
-------------
The configuration of awesome is done by creating a ~/.awesomerc file.
An example is provided in the sources.