Lua 5.2 compatibility fork
C Lua C++ Objective-C Shell
Switch branches/tags
Nothing to show
Latest commit 7ca2df9 Aug 5, 2012 st Upstream merge
Permalink
Failed to load latest commit information.
build-tests use CMake check_function_exists() for execinfo Oct 11, 2010
build-utils Stop using gperf Sep 2, 2010
common Upstream merge Aug 4, 2012
icons icons: remove invaders Sep 8, 2009
lib Upstream merge Aug 4, 2012
luadoc Upstream merge Aug 4, 2012
manpages Upstream merge Aug 4, 2012
objects Upstream merge Aug 4, 2012
themes Upstream merge Aug 4, 2012
utils Upstream merge Aug 4, 2012
.gitignore Modified .gitignore Jun 15, 2012
AUTHORS update Arnaud commit years Aug 24, 2009
BUGS BUG's page Apr 18, 2008
CMakeLists.txt Upstream merge Aug 4, 2012
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 Upstream merge Aug 4, 2012
awesome.desktop Desktop file fixes. Jun 5, 2012
awesome.doxygen.in awesome.doxygen: doxygen configuration fixes. Sep 4, 2009
awesome.h remove encoding=utf-8 from modelines Sep 11, 2011
awesomeConfig.cmake Remove PREFIX, use CMAKE_INSTALL_PREFIX Jun 15, 2012
awesomerc.lua.in Upstream merge Aug 4, 2012
awesomerc.lua.in.orig Upstream merge Aug 4, 2012
banning.c remove encoding=utf-8 from modelines Sep 11, 2011
banning.h remove encoding=utf-8 from modelines Sep 11, 2011
color.c C color code: Ignore alpha component (FS#966) Apr 7, 2012
color.h remove encoding=utf-8 from modelines Sep 11, 2011
config.h.in test for __builtin_clz() and fallback to an inline implementation. Oct 11, 2010
dbus.c lua_objlen wrapped in luaA_rawlen Jun 12, 2012
dbus.h remove encoding=utf-8 from modelines Sep 11, 2011
draw.c Upstream merge Aug 4, 2012
draw.h Upstream merge Aug 4, 2012
event.c Upstream merge Aug 4, 2012
event.h remove encoding=utf-8 from modelines Sep 11, 2011
ewmh.c Don't pass cairo surfaces around on the lua stack May 28, 2012
ewmh.h Don't pass cairo surfaces around on the lua stack May 28, 2012
globalconf.h Add a wallpaper_changed signal Apr 7, 2012
keygrabber.c Renamed luaL_reg to luaL_Reg Jun 12, 2012
keygrabber.h remove encoding=utf-8 from modelines Sep 11, 2011
keyresolv.c remove encoding=utf-8 from modelines Sep 11, 2011
keyresolv.h remove encoding=utf-8 from modelines Sep 11, 2011
luaa.c Changed lua stack indexing with negative values Jun 9, 2012
luaa.h Wrapped luaL_register Jun 12, 2012
mouse.c Renamed luaL_reg to luaL_Reg Jun 12, 2012
mouse.h remove encoding=utf-8 from modelines Sep 11, 2011
mousegrabber.c Renamed luaL_reg to luaL_Reg Jun 12, 2012
mousegrabber.h remove encoding=utf-8 from modelines Sep 11, 2011
property.c Don't pass cairo surfaces around on the lua stack May 28, 2012
property.h remove encoding=utf-8 from modelines Sep 11, 2011
root.c Upstream merge Aug 4, 2012
screen.c Renamed luaL_reg to luaL_Reg Jun 12, 2012
screen.h remove encoding=utf-8 from modelines Sep 11, 2011
selection.c remove encoding=utf-8 from modelines Sep 11, 2011
selection.h remove encoding=utf-8 from modelines Sep 11, 2011
spawn.c Minor readability fixes, STREQ()-like macros added Nov 18, 2011
spawn.h remove encoding=utf-8 from modelines Sep 11, 2011
stack.c remove encoding=utf-8 from modelines Sep 11, 2011
stack.h remove encoding=utf-8 from modelines Sep 11, 2011
strut.c remove encoding=utf-8 from modelines Sep 11, 2011
strut.h remove encoding=utf-8 from modelines Sep 11, 2011
systray.c remove encoding=utf-8 from modelines Sep 11, 2011
systray.h remove encoding=utf-8 from modelines Sep 11, 2011
xwindow.c remove encoding=utf-8 from modelines Sep 11, 2011
xwindow.h remove encoding=utf-8 from modelines Sep 11, 2011

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.