Go to file
Julien Danjou a41c25c0f5 modify the tell function to respect spaces 2008-01-07 15:48:42 +01:00
icons/layouts optimize PNG files 2007-12-29 11:26:25 +01:00
layouts Rewrite everything about client geoemtry, resize, etc. 2008-01-06 20:36:39 +01:00
widgets modify the tell function to respect spaces 2008-01-07 15:48:42 +01:00
.gitignore add manpages to .gitignore 2008-01-06 21:47: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.am graph widget added 2008-01-06 20:51:40 +01:00
README change README for autogen.sh 2008-01-05 11:44:05 +01:00
STYLE The preferred line length is 80 characters. 2007-12-18 11:27:26 +01:00
autogen.sh autogen.sh added 2008-01-05 11:42:28 +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 add comment about XGetWA 2008-01-07 14:11:14 +01:00
awesome.doxygen.in switch to autotools as build system 2008-01-04 20:49:49 +01:00
awesome.h simplify unmanage code 2008-01-06 21:57:53 +01:00
awesomerc add default binding to restart awesome 2008-01-03 21:58:08 +01:00
awesomerc.1.txt add show_all option to tasklist 2008-01-07 11:20:24 +01:00
client.c restack on max 2008-01-06 23:37:53 +01:00
client.h simplify unmanage code 2008-01-06 21:57:53 +01:00
config.c add show_all option to tasklist 2008-01-07 11:20:24 +01:00
config.h Revert "force windows to tile mode" - it's useful afterall to not consider "no value" as "false" 2008-01-07 00:36:45 +01:00
configure.ac Document AWESOME_CFLAGS, and use only with gcc 2008-01-04 22:06:52 +01:00
draw.c not needed i_tmp variable removed and using h_index instead 2008-01-07 09:24:31 +01:00
draw.h rename textwidth to draw_textwidth 2008-01-06 22:57:23 +01:00
event.c partial support for mouse bindings on root window when window displayed 2008-01-07 10:06:04 +01:00
event.h add 2008 copyright notice 2008-01-02 16:59:43 +01:00
ewmh.c fix some weird conditions with fullscreen/max/arrange 2008-01-06 23:27:47 +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 move toggle floating function to layout.c and fix problem when moving with mouse tiled windows 2008-01-07 13:38:26 +01:00
layout.h move toggle floating function to layout.c and fix problem when moving with mouse tiled windows 2008-01-07 13:38:26 +01:00
mouse.c move toggle floating function to layout.c and fix problem when moving with mouse tiled windows 2008-01-07 13:38:26 +01:00
mouse.h replace UICB_PROTO macro by a typedef 2008-01-01 17:25:48 +01:00
rules.c Revert "force windows to tile mode" - it's useful afterall to not consider "no value" as "false" 2008-01-07 00:36:45 +01:00
rules.h Revert "force windows to tile mode" - it's useful afterall to not consider "no value" as "false" 2008-01-07 00:36:45 +01:00
screen.c fix move to screen with floating/non-floating win 2008-01-06 21:43:19 +01:00
screen.h rework headers inclusion 2008-01-01 18:02:36 +01:00
statusbar.c cosmetic 2008-01-06 22:46:59 +01:00
statusbar.h typedef enum Position 2008-01-04 19:12:07 +01:00
tag.c move toggle floating function to layout.c and fix problem when moving with mouse tiled windows 2008-01-07 13:38:26 +01:00
tag.h move toggle floating function to layout.c and fix problem when moving with mouse tiled windows 2008-01-07 13:38:26 +01:00
uicb.c rework uicb, cosmetic, use a_str functions 2008-01-06 22:42:06 +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 add a_strncat() 2008-01-07 15:48:04 +01:00
widget.c graph widget added 2008-01-06 20:51:40 +01:00
widget.h graph widget added 2008-01-06 20:51:40 +01:00
window.c simplify window_configure() args 2008-01-05 20:25:55 +01:00
window.h simplify window_configure() args 2008-01-05 20:25:55 +01:00
xutil.c remove Display arg of xgettextprop() 2008-01-06 22:53:40 +01:00
xutil.h remove Display arg of xgettextprop() 2008-01-06 22:53:40 +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
------------
If building from git sources, run "./autogen.sh". When autoreconf has
finished, you can follow the following instructions for building a dist
tarball.

After extracting the dist tarball, run "./configure --help" and figure out
what you might want to adapt for your system. Then run ./configure with the
proper parameters, and build and install:

  ./configure [...]
  make
  make install # might need root permissions

If you're using gcc as your compiler and do not want awesome's default set
of warning flags, add AWESOME_CFLAGS="" to your "make" lines.

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.