Skip to content
No description or website provided.
C Lua Shell
Find file
Latest commit 0457992 Jun 8, 2010 @paul Add iconv needed for osx
Failed to load latest commit information.
build-tests awesomeConfig: test for execinfo.h/backtrace() Oct 27, 2009
build-utils Fix gperf usage (FS#740) Mar 15, 2010
common luaclass: take care of inheritance garbage collection May 28, 2010
icons icons: remove invaders Sep 8, 2009
lib naughty: return nothing, not nil Jun 6, 2010
luadoc Update API docs for recent change to spawn May 3, 2010
manpages German translation of manpages May 3, 2010
objects ewmh: use client signals to update NET_ACTIVE_WINDOW May 28, 2010
themes awful.widget.tasklist: use symbols chars rather than images May 28, 2010
utils awsetbg was missing break May 17, 2010
.gitignore gitignore: remove awesome-client Apr 11, 2009
AUTHORS update Arnaud commit years Aug 24, 2009
BUGS BUG's page Apr 18, 2008
CMakeLists.txt Add iconv needed for osx Jun 8, 2010
LICENSE chance license to GPLv2 Sep 12, 2007
Makefile build: allow to specify cmake args May 8, 2009
PATCHES PATCHES: add more rules Sep 2, 2009
README Grammar/spelling corrections in comments and docs. Aug 31, 2009
STYLE STYLE: add prefix rule Aug 21, 2009
awesome-version-internal.h.in cmake: consolidate version strings Jun 22, 2008
awesome.c Check for UNMAPPED instead of UNVIEWABLE Mar 29, 2010
awesome.desktop desktop: change description Oct 2, 2008
awesome.doxygen.in awesome.doxygen: doxygen configuration fixes. Sep 4, 2009
awesome.h factorize quit/exec elements, and reparent systray Sep 2, 2008
awesomeConfig.cmake build: fix typo Dec 29, 2009
awesomerc.lua.in awful.menu: Change menu:show() args set Apr 14, 2010
banning.c window: rename to xwindow Oct 20, 2009
banning.h Re-add lazy banning Sep 28, 2009
color.c structs: rename to globalconf Sep 7, 2009
color.h color: do not take pointer to push Aug 17, 2009
config.h.in build: detect endianness at compile time Apr 27, 2009
dbus.c dbus: fix compiling error Jun 6, 2010
dbus.h dbus: allow usage of the system bus Apr 18, 2009
draw.c Do not check if we have enough space to draw (FS#731) Mar 25, 2010
draw.h image: move into objects Oct 27, 2009
event.c client: remove internal geometry May 28, 2010
event.h client: move stack code into stack May 28, 2010
ewmh.c ewmh: use client signals to update NET_ACTIVE_WINDOW May 28, 2010
ewmh.h ewmh: use client signals to update NET_ACTIVE_WINDOW May 28, 2010
font.c font: remove draw_ prefix in names Oct 27, 2009
font.h font: remove draw_ prefix in names Oct 27, 2009
globalconf.h globalconf: move conffile out Nov 10, 2009
keygrabber.c key: split resolving in keyresolv May 28, 2010
keygrabber.h keygrabber: add stop() method Nov 10, 2008
keyresolv.c key: split resolving in keyresolv May 28, 2010
keyresolv.h key: split resolving in keyresolv May 28, 2010
luaa.c window: import class May 28, 2010
luaa.h luaa: luaA_next is static Nov 9, 2009
mouse.c mouse: coords() get silent parameter Nov 6, 2009
mouse.h mouse: split button out Apr 26, 2009
mousegrabber.c structs: rename to globalconf Sep 7, 2009
mousegrabber.h mousegrabber: import Dec 12, 2008
property.c property: remove unknown code May 28, 2010
property.h structs: rename to globalconf Sep 7, 2009
root.c window: rename to xwindow Oct 20, 2009
screen.c client: implements maximized and fullscreen requests with Lua May 28, 2010
screen.h screen: store RandR information May 28, 2010
selection.c Grammar/spelling corrections in comments and docs. Aug 31, 2009
selection.h selection: do not use a useless module Jan 6, 2009
spawn.c Update API docs for recent change to spawn May 3, 2010
spawn.h spawn: remove useless proto Nov 16, 2009
stack.c stack: stack_client_* calls stack_windows() May 28, 2010
stack.h client: move stack code into stack May 28, 2010
strut.c Fix doxygen generation warnings Aug 26, 2009
strut.h strut: import strut_has_value() Aug 28, 2009
systray.c window: rename to xwindow Oct 20, 2009
systray.h systray: add some cleanup code Sep 3, 2008
xwindow.c xwindow: add xwindow_set_border_color helper function May 28, 2010
xwindow.h xwindow: add xwindow_set_border_color helper function May 28, 2010

README

awesome
=======
awesome is a highly configurable, next generation framework window manager for X.

Building and installation
-------------------------
After extracting the dist tarball, run:

  make

This will create a build directory, run cmake in it and build awesome.

After building is finished, you can install:

  make install # you might need root permissions

Running awesome
---------------
You can directly select awesome from your display manager. If not, you can
add the following line to your .xinitrc to start awesome using startx
or to .xsession to start awesome using your display manager:

    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 $XDG_CONFIG_HOME/awesome/rc.lua file.
An example configuration named "awesomerc.lua.in" is provided in the source.

Troubleshooting
---------------
In most systems any message printed by awesome (including warnings and errors)
are written to $HOME/.xsession-errors.

If awesome does not start or the configuration file is not producing the desired
results the user should examine this file to gain insight into the problem.
Something went wrong with that request. Please try again.