Go to file
Julien Danjou 65fe4e8933 add support for right/left statusbar position and clicks 2008-01-04 13:04:34 +01:00
icons/layouts optimize PNG files 2007-12-29 11:26:25 +01:00
layouts add 2008 copyright notice 2008-01-02 16:59:43 +01:00
widgets add support for right/left statusbar position and clicks 2008-01-04 13:04:34 +01:00
.gitignore remove dual-config: awesomerc is now preprocessed and compiled in awesome 2007-12-13 11:16:43 +01:00
AUTHORS add 2008 copyright notice 2008-01-02 16:59:43 +01:00
LICENSE chance license to GPLv2 2007-09-12 14:29:51 +02:00
Makefile fix widget and icons layouts installation 2008-01-03 13:22:37 +01:00
README Add more requirements to README. 2007-12-17 18:21:47 +01:00
STYLE The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
awesome-client-common.c add 2008 copyright notice 2008-01-02 16:59:43 +01:00
awesome-client.1.txt minor documentation fix 2007-12-15 07:36:06 +01:00
awesome-client.c add 2008 copyright notice 2008-01-02 16:59:43 +01:00
awesome-client.h add 2008 copyright notice 2008-01-02 16:59:43 +01:00
awesome.1.txt add default binding to restart awesome 2008-01-03 21:58:08 +01:00
awesome.c remove some get_phys_screen() calls 2008-01-02 17:41:03 +01:00
awesome.doxygen generate graphs 2008-01-01 17:45:05 +01:00
awesome.h add 2008 copyright notice 2008-01-02 16:59:43 +01:00
awesomerc add default binding to restart awesome 2008-01-03 21:58:08 +01:00
awesomerc.1.txt add option to show appicons in tasklist 2008-01-03 19:21:36 +01:00
client.c get rid of Client phys_screen 2008-01-02 19:26:55 +01:00
client.h add 2008 copyright notice 2008-01-02 16:59:43 +01:00
config.c add option to show appicons in tasklist 2008-01-03 19:21:36 +01:00
config.h add support for _NET_WM_STATE_SKIP_TASKBAR 2008-01-03 13:15:15 +01:00
config.mk add new tasklist widget 2008-01-03 12:39:28 +01:00
draw.c add draw_get_align() to translate string to enum 2008-01-03 16:02:32 +01:00
draw.h add draw_get_align() to translate string to enum 2008-01-03 16:02:32 +01:00
event.c optimize if statements 2008-01-04 13:04:15 +01:00
event.h add 2008 copyright notice 2008-01-02 16:59:43 +01:00
ewmh.c move NetWMIcon get to ewmh.c 2008-01-03 19:02:23 +01:00
ewmh.h move NetWMIcon get to ewmh.c 2008-01-03 19:02:23 +01:00
focus.c bug fix: wrong tag tested 2008-01-03 12:14:24 +01:00
focus.h add 2008 copyright notice 2008-01-02 16:59:43 +01:00
layout.c rework headers inclusion 2008-01-01 18:02:36 +01:00
layout.h use LayoutArrange and Uicb type into config.h ; move some functions from layout.c to client.c 2008-01-01 17:37:16 +01:00
mouse.c get rid of Client phys_screen 2008-01-02 19:26:55 +01:00
mouse.h replace UICB_PROTO macro by a typedef 2008-01-01 17:25:48 +01:00
rules.c optimize rule usage 2008-01-02 12:44:18 +01:00
rules.h optimize rule usage 2008-01-02 12:44:18 +01:00
screen.c rework headers inclusion 2008-01-01 18:02:36 +01:00
screen.h rework headers inclusion 2008-01-01 18:02:36 +01:00
statusbar.c rework headers inclusion 2008-01-01 18:02:36 +01:00
statusbar.h rework headers inclusion 2008-01-01 18:02:36 +01:00
tag.c uicb_tag_view not working correctly with null argument 2008-01-03 09:44:13 +01:00
tag.h new uicb: tag_create 2008-01-02 17:10:32 +01:00
uicb.c new uicb: tag_create 2008-01-02 17:10:32 +01:00
uicb.h replace UICB_PROTO macro by a typedef 2008-01-01 17:25:48 +01:00
util.c Remove single occurance of die, and then remove die itself. 2007-12-19 10:42:00 +01:00
util.h remove LAYOUT_PROTO, use a LayoutArrange typedef 2008-01-01 17:33:12 +01:00
widget.c add new tasklist widget 2008-01-03 12:39:28 +01:00
widget.h add a align option to draw_text 2008-01-03 15:57:07 +01:00
window.c remove LAYOUT_PROTO, use a LayoutArrange typedef 2008-01-01 17:33:12 +01:00
window.h replace UICB_PROTO macro by a typedef 2008-01-01 17:25:48 +01:00
xutil.c remove some get_phys_screen() calls 2008-01-02 17:41:03 +01:00
xutil.h rework headers inclusion 2008-01-01 18:02:36 +01: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, libconfuse and cairo.
Creating the man pages also requires recent versions of the asciidoc and xmlto
tools.

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.)

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