Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 build-tests awesomeConfig: test for execinfo.h/backtrace() October 27, 2009
Octocat-spinner-32 build-utils
Octocat-spinner-32 common
Octocat-spinner-32 icons
Octocat-spinner-32 lib naughty: return nothing, not nil June 06, 2010
Octocat-spinner-32 luadoc
Octocat-spinner-32 manpages
Octocat-spinner-32 objects ewmh: use client signals to update NET_ACTIVE_WINDOW May 28, 2010
Octocat-spinner-32 themes awful.widget.tasklist: use symbols chars rather than images May 28, 2010
Octocat-spinner-32 utils awsetbg was missing break May 17, 2010
Octocat-spinner-32 .gitignore
Octocat-spinner-32 AUTHORS update Arnaud commit years August 24, 2009
Octocat-spinner-32 BUGS BUG's page April 18, 2008
Octocat-spinner-32 CMakeLists.txt
Octocat-spinner-32 LICENSE
Octocat-spinner-32 Makefile
Octocat-spinner-32 PATCHES PATCHES: add more rules September 02, 2009
Octocat-spinner-32 README
Octocat-spinner-32 STYLE
Octocat-spinner-32 cmake: consolidate version strings June 22, 2008
Octocat-spinner-32 awesome.c
Octocat-spinner-32 awesome.desktop desktop: change description October 02, 2008
Octocat-spinner-32 awesome.doxygen: doxygen configuration fixes. September 04, 2009
Octocat-spinner-32 awesome.h
Octocat-spinner-32 awesomeConfig.cmake
Octocat-spinner-32 Change menu:show() args set April 14, 2010
Octocat-spinner-32 banning.c window: rename to xwindow October 20, 2009
Octocat-spinner-32 banning.h
Octocat-spinner-32 color.c
Octocat-spinner-32 color.h
Octocat-spinner-32 build: detect endianness at compile time April 27, 2009
Octocat-spinner-32 dbus.c
Octocat-spinner-32 dbus.h dbus: allow usage of the system bus April 18, 2009
Octocat-spinner-32 draw.c Do not check if we have enough space to draw (FS#731) March 25, 2010
Octocat-spinner-32 draw.h image: move into objects October 27, 2009
Octocat-spinner-32 event.c
Octocat-spinner-32 event.h
Octocat-spinner-32 ewmh.c ewmh: use client signals to update NET_ACTIVE_WINDOW May 28, 2010
Octocat-spinner-32 ewmh.h ewmh: use client signals to update NET_ACTIVE_WINDOW May 28, 2010
Octocat-spinner-32 font.c
Octocat-spinner-32 font.h
Octocat-spinner-32 globalconf.h
Octocat-spinner-32 keygrabber.c key: split resolving in keyresolv May 28, 2010
Octocat-spinner-32 keygrabber.h keygrabber: add stop() method November 10, 2008
Octocat-spinner-32 keyresolv.c key: split resolving in keyresolv May 28, 2010
Octocat-spinner-32 keyresolv.h
Octocat-spinner-32 luaa.c
Octocat-spinner-32 luaa.h luaa: luaA_next is static November 09, 2009
Octocat-spinner-32 mouse.c
Octocat-spinner-32 mouse.h
Octocat-spinner-32 mousegrabber.c
Octocat-spinner-32 mousegrabber.h
Octocat-spinner-32 property.c property: remove unknown code May 28, 2010
Octocat-spinner-32 property.h
Octocat-spinner-32 root.c
Octocat-spinner-32 screen.c
Octocat-spinner-32 screen.h screen: store RandR information May 28, 2010
Octocat-spinner-32 selection.c Grammar/spelling corrections in comments and docs. August 31, 2009
Octocat-spinner-32 selection.h selection: do not use a useless module January 06, 2009
Octocat-spinner-32 spawn.c
Octocat-spinner-32 spawn.h
Octocat-spinner-32 stack.c stack: stack_client_* calls stack_windows() May 28, 2010
Octocat-spinner-32 stack.h
Octocat-spinner-32 strut.c Fix doxygen generation warnings August 26, 2009
Octocat-spinner-32 strut.h
Octocat-spinner-32 systray.c window: rename to xwindow October 20, 2009
Octocat-spinner-32 systray.h systray: add some cleanup code September 03, 2008
Octocat-spinner-32 xwindow.c xwindow: add xwindow_set_border_color helper function May 28, 2010
Octocat-spinner-32 xwindow.h
awesome is a highly configurable, next generation framework window manager for X.

Building and installation
After extracting the dist tarball, run:


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.: exec awesome

(This will start awesome on display :1 of the host

The configuration of awesome is done by creating a $XDG_CONFIG_HOME/awesome/rc.lua file.
An example configuration named "" is provided in the source.

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.