Go to file
Julien Danjou 4662cf109e introduce get_screen_count(...) function 2007-09-27 17:13:30 +02:00
layouts introduce get_xinerama_screen_bycoord(...) 2007-09-27 17:13:30 +02:00
AUTHORS typo 2007-09-19 19:04:04 +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 chance license to GPLv2 2007-09-12 14:29:51 +02:00
TODO add uicb_setborder to change conf borderpx while running 2007-09-18 23:36:52 +02:00
awesome.1 update manpage 2007-09-18 23:22:39 +02:00
awesome.c add -c option to specify configuration file 2007-09-26 21:22:30 +02:00
awesome.doxygen set version to devel 2007-09-18 23:30:10 +02:00
awesome.h Add UICB_PROTO to common.h (new) to declare uicb_functions 2007-09-24 14:40:40 +02:00
awesomerc change urxvt by x-terminal-emulator in default config 2007-09-26 20:00:16 +02:00
client.c make moveresize work with +/- as others 2007-09-27 12:30:18 +02:00
client.h introduce get_xinerama_screen_bycoord(...) 2007-09-27 17:13:30 +02:00
common.h add a LAYOUT_PROTO to common.h and use it 2007-09-24 14:59:29 +02:00
config.c add -c option to specify configuration file 2007-09-26 21:22:30 +02:00
config.h add -c option to specify configuration file 2007-09-26 21:22:30 +02:00
config.mk new feature: add max layout 2007-09-21 00:30:32 +02:00
draw.c simplify drawsquare() 2007-09-20 20:11:33 +02:00
draw.h simplify drawsquare() 2007-09-20 20:11:33 +02:00
event.c introduce get_xinerama_screen_bycoord(...) 2007-09-27 17:13:30 +02:00
event.h add screen args to grabkeys() 2007-09-15 22:45:08 +02:00
layout.c introduce get_xinerama_screen_bycoord(...) 2007-09-27 17:13:30 +02:00
layout.h Add UICB_PROTO to common.h (new) to declare uicb_functions 2007-09-24 14:40:40 +02:00
screen.c introduce get_screen_count(...) function 2007-09-27 17:13:30 +02:00
screen.h introduce get_screen_count(...) function 2007-09-27 17:13:30 +02:00
statusbar.c add mwfact to statusbar printing 2007-09-24 20:23:05 +02:00
statusbar.h simplfiy drawstatus() remove screen useless arg 2007-09-24 16:23:49 +02:00
tag.c bug fix: apply selected layouts for tag in uicb_tag_view{next,prev} 2007-09-27 16:24:42 +02:00
tag.h move Regs into tag.c 2007-09-24 18:02:03 +02:00
util.c add a_strncmp() to util.h and use a_str*() functions everywhere 2007-09-24 17:58:50 +02:00
util.h add a_strncmp() to util.h and use a_str*() functions everywhere 2007-09-24 17:58:50 +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.