Go to file
Julien Danjou bb06e80199 simplify some stuff, cosmetic 2008-01-01 16:29:58 +01:00
icons/layouts optimize PNG files 2007-12-29 11:26:25 +01:00
layouts use get_curent_tags() in tile.c 2007-12-27 11:50:09 +01:00
widgets simplify some stuff, cosmetic 2008-01-01 16:29:58 +01:00
.gitignore remove dual-config: awesomerc is now preprocessed and compiled in awesome 2007-12-13 11:16:43 +01:00
AUTHORS add Aldo as AUTHORS 2007-12-19 10:44:41 +01:00
LICENSE chance license to GPLv2 2007-09-12 14:29:51 +02:00
Makefile externalize EWMH handling 2007-12-27 17:27:20 +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 The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
awesome-client.1.txt minor documentation fix 2007-12-15 07:36:06 +01:00
awesome-client.c The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
awesome-client.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
awesome.1.txt remove default reloadconfig un manpage 2007-12-15 19:22:47 +01:00
awesome.c clean some awesome.c stuff 2007-12-31 10:10:49 +01:00
awesome.doxygen Make doxygen documentation less cluttered. 2007-12-19 10:42:43 +01:00
awesome.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
awesomerc allow to have several statusbar 2007-12-30 21:00:34 +01:00
awesomerc.1.txt update manpage for several statusbar 2007-12-30 21:13:11 +01:00
client.c allow to have several statusbar 2007-12-30 21:00:34 +01:00
client.h documente some functions and simplify client_saveprops() proto 2007-12-30 15:08:38 +01:00
common.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
config.c simplify some stuff, cosmetic 2008-01-01 16:29:58 +01:00
config.h allow to have several statusbar 2007-12-30 21:00:34 +01:00
config.mk cosmetic 2007-12-28 12:39:40 +01:00
draw.c code documentation update 2007-12-30 15:11:37 +01:00
draw.h draw_text don't pad with font->height / 2 by default: padding is now an arg 2007-12-30 14:42:51 +01:00
event.c allow to have several statusbar 2007-12-30 21:00:34 +01:00
event.h add support for NET_CLOSE_WINDOW 2007-12-27 20:49:38 +01:00
ewmh.c add support for _NET_CURRENT_DESKTOP messages 2007-12-28 22:16:27 +01:00
ewmh.h add support for NET_WM_STATE and NET_WM_STATE_STICKY 2007-12-27 22:39:29 +01:00
focus.c change uicb_focus_history() to use focus_get_latest_client_for_tags() which now takes an index as arg 2007-12-28 14:27:15 +01:00
focus.h simplify sel handling 2007-12-27 19:57:46 +01:00
layout.c allow to have several statusbar 2007-12-30 21:00:34 +01:00
layout.h add support for _NET_WM_STATE_FULLSCREEN 2007-12-28 18:31:31 +01:00
mouse.c allow to have several statusbar 2007-12-30 21:00:34 +01:00
mouse.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
rules.c remove Display from Client struct 2007-12-27 23:10:43 +01:00
rules.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
screen.c Typo in screen.c:get_display_area causing display area to be miscalculated 2007-12-31 18:37:28 +01:00
screen.h merge draw_get_image_{width,height}() into draw_get_image_size() 2007-12-29 21:44:44 +01:00
statusbar.c draw statusbar after init 2007-12-31 10:04:03 +01:00
statusbar.h allow to have several statusbar 2007-12-30 21:00:34 +01:00
tag.c documente some functions and simplify client_saveprops() proto 2007-12-30 15:08:38 +01:00
tag.h add support for _NET_CURRENT_DESKTOP messages 2007-12-28 22:16:27 +01:00
uicb.c allow to have several statusbar 2007-12-30 21:00:34 +01:00
uicb.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
util.c Remove single occurance of die, and then remove die itself. 2007-12-19 10:42:00 +01:00
util.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
widget.c allow to have several statusbar 2007-12-30 21:00:34 +01:00
widget.h new width: progressbar 2007-12-23 14:27:56 +01:00
window.c remove Display as arg from window_*() fcts 2007-12-30 15:24:51 +01:00
window.h remove Display as arg from window_*() fcts 2007-12-30 15:24:51 +01:00
xutil.c Change awesome_config -> AwesomeConf. 2007-12-19 10:43:02 +01:00
xutil.h Make textbox foreground and background configurable. 2007-12-19 10:41:50 +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.