Go to file
Julien Danjou ab75756d62 remove a DefaultScreen() 2007-09-16 14:56:08 +02:00
layouts spawn X client in the right head and add screen arg to layouts 2007-09-16 01:36:26 +02:00
AUTHORS chance license to GPLv2 2007-09-12 14:29:51 +02:00
LICENSE chance license to GPLv2 2007-09-12 14:29:51 +02:00
Makefile create statusbar.c and move things from draw.c 2007-09-15 15:16:53 +02:00
README chance license to GPLv2 2007-09-12 14:29:51 +02:00
TODO add TODO file 2007-09-16 14:55:16 +02:00
awesome.1 change man page a bit 2007-09-10 14:40:24 +02:00
awesome.c enhance multihead support, with N conf/dc 2007-09-16 14:56:08 +02:00
awesome.doxygen rename jdwm to awesome 2007-09-10 12:06:54 +02:00
awesome.h add screen arg to uicb* 2007-09-16 01:05:43 +02:00
awesomerc change key for statusbar position config 2007-09-15 15:00:42 +02:00
client.c add screen arg to uicb* 2007-09-16 01:05:43 +02:00
client.h add screen arg to uicb* 2007-09-16 01:05:43 +02:00
config.c try to load fixed font if other fails 2007-09-15 21:40:57 +02:00
config.h spawn X client in the right head and add screen arg to layouts 2007-09-16 01:36:26 +02:00
config.mk remove grid layout 2007-09-15 12:39:33 +02:00
draw.c create statusbar.c and move things from draw.c 2007-09-15 15:16:53 +02:00
draw.h move updatebarpos to statusbar.c 2007-09-15 15:26:51 +02:00
event.c enhance multihead support, with N conf/dc 2007-09-16 14:56:08 +02:00
event.h add screen args to grabkeys() 2007-09-15 22:45:08 +02:00
layout.c spawn X client in the right head and add screen arg to layouts 2007-09-16 01:36:26 +02:00
layout.h add screen arg to uicb* 2007-09-16 01:05:43 +02:00
screen.c get_screen_info get screen as arg 2007-09-15 23:09:02 +02:00
screen.h get_screen_info get screen as arg 2007-09-15 23:09:02 +02:00
statusbar.c add screen arg to uicb* 2007-09-16 01:05:43 +02:00
statusbar.h add screen arg to uicb* 2007-09-16 01:05:43 +02:00
tag.c remove a DefaultScreen() 2007-09-16 14:56:08 +02:00
tag.h add screen arg to uicb* 2007-09-16 01:05:43 +02:00
util.c spawn X client in the right head and add screen arg to layouts 2007-09-16 01:36:26 +02:00
util.h add screen arg to uicb* 2007-09-16 01:05:43 +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 libconfig.

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.