Go to file
Julien Danjou 91cc5a4618 use image instead of symbols for layouts 2007-12-27 00:13:44 +01:00
icons/layouts use image instead of symbols for layouts 2007-12-27 00:13:44 +01:00
layouts Clean get_screen_info and get_display_info. 2007-12-23 09:53:50 +01:00
widgets use image instead of symbols for layouts 2007-12-27 00:13:44 +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 Widget-ise the statusbar. 2007-12-15 10:15:42 +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 use image instead of symbols for layouts 2007-12-27 00:13:44 +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 use image instead of symbols for layouts 2007-12-27 00:13:44 +01:00
awesomerc.1.txt Some awesomerc info add-ons. 2007-12-26 21:54:27 +01:00
client.c add new UICB: uicb_focus_client_byname 2007-12-23 16:16:02 +01:00
client.h add new UICB: uicb_focus_client_byname 2007-12-23 16:16:02 +01:00
common.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
config.c use image instead of symbols for layouts 2007-12-27 00:13:44 +01:00
config.h use image instead of symbols for layouts 2007-12-27 00:13:44 +01:00
config.mk new width: progressbar 2007-12-23 14:27:56 +01:00
draw.c use image instead of symbols for layouts 2007-12-27 00:13:44 +01:00
draw.h use image instead of symbols for layouts 2007-12-27 00:13:44 +01:00
event.c add support for Urgency hint 2007-12-23 15:16:10 +01:00
event.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
focus.c add new UICB: uicb_focus_client_byname 2007-12-23 16:16:02 +01:00
focus.h add new UICB: uicb_focus_client_byname 2007-12-23 16:16:02 +01:00
layout.c Clean get_screen_info and get_display_info. 2007-12-23 09:53:50 +01:00
layout.h introduce get_current_tags() and deprecate get_current_{tag,layout}() 2007-12-23 16:28:40 +01:00
mouse.c Clean get_screen_info and get_display_info. 2007-12-23 09:53:50 +01:00
mouse.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
rules.c The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
rules.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
screen.c cosmetic 2007-12-23 09:56:41 +01:00
screen.h remove ScreenInfo typedef and move Area into screen.h 2007-12-23 09:55:46 +01:00
statusbar.c Clean get_screen_info and get_display_info. 2007-12-23 09:53:50 +01:00
statusbar.h Clean interface of statusbar_update_position. 2007-12-23 09:51:44 +01:00
tag.c introduce get_current_tags() and deprecate get_current_{tag,layout}() 2007-12-23 16:28:40 +01:00
tag.h introduce get_current_tags() and deprecate get_current_{tag,layout}() 2007-12-23 16:28:40 +01:00
uicb.c add new UICB: uicb_focus_client_byname 2007-12-23 16:16:02 +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 new width: progressbar 2007-12-23 14:27:56 +01:00
widget.h new width: progressbar 2007-12-23 14:27:56 +01:00
window.c Change awesome_config -> AwesomeConf. 2007-12-19 10:43:02 +01:00
window.h The preferred line length is 80 characters. 2007-12-18 11:27:26 +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.