Mirror of Awesome WM window manager
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Daniel Hahler 8919faa7b3 doc: fix warnings from doxygen 5 years ago
build-tests use CMake check_function_exists() for execinfo 9 years ago
build-utils Bump minimum lgi dependency to 0.7.0 6 years ago
common luaA_object_emit_signal: check for valid object 5 years ago
icons icons: remove invaders 10 years ago
lib Merge pull request #105 from blueyed/awful-util-deprecate-once-per-traceback 5 years ago
luadoc Add luadoc for dbus.emit_signal() 5 years ago
manpages Remove F1-9 bindings from the manpages. 7 years ago
objects Add support for setting client.name 5 years ago
spec awful.util.unittest: Move into spec/ 5 years ago
themes taglist: Add [bg|fg]_empty 6 years ago
utils Remove all traces of awsetbg and wallpaper setters 7 years ago
.gitignore gitignore: remove awesome-client 11 years ago
AUTHORS update Arnaud commit years 10 years ago
BUGS BUG's page 12 years ago
CMakeLists.txt timer: Move from C to lua as gears.timer 5 years ago
LICENSE chance license to GPLv2 12 years ago
Makefile Makefile: distclean is a phony target 5 years ago
PATCHES PATCHES: Mention the unit tests 5 years ago
README.md Move README to README.md 5 years ago
STYLE STYLE: add prefix rule 10 years ago
awesome-version-internal.h.in cmake: consolidate version strings 11 years ago
awesome.c awful.rules.execute: use delayed_call for emitting request::activate 5 years ago
awesome.desktop Remove NoDisplay from desktop file 7 years ago
awesome.doxygen.in doc: remove obsolete doxygen settings 5 years ago
awesome.h remove encoding=utf-8 from modelines 8 years ago
awesomeConfig.cmake cmake: Remove useless program checks 5 years ago
awesomerc.lua.in rc.lua: Prevent clients from being lost on RANRD changes 5 years ago
banning.c doc: fix warnings from doxygen 5 years ago
banning.h Clean up header includes 5 years ago
color.c Clean up header includes 5 years ago
color.h remove encoding=utf-8 from modelines 8 years ago
config.h.in test for __builtin_clz() and fallback to an inline implementation. 9 years ago
config.ld.in Use LDoc instead of Luadoc (FS#1006) 7 years ago
dbus.c doc: fix warnings from doxygen 5 years ago
dbus.h remove encoding=utf-8 from modelines 8 years ago
draw.c doc: fix warnings from doxygen 5 years ago
draw.h draw: Add function for finding a visual by id 6 years ago
event.c Hide globalconf.L 5 years ago
event.h Clean up header includes 5 years ago
ewmh.c doc: fix warnings from doxygen 5 years ago
ewmh.h Clean up header includes 5 years ago
globalconf.h Hide globalconf.L 5 years ago
keygrabber.c Clean up header includes 5 years ago
keygrabber.h Clean up header includes 5 years ago
keyresolv.c Clean up header includes 5 years ago
keyresolv.h Clean up header includes 5 years ago
luaa.c timer: Move from C to lua as gears.timer 5 years ago
luaa.h Also allow screen objects were screen indices are expected 5 years ago
mouse.c Fix some more dubious uses of globalconf.L 5 years ago
mouse.h Revert "Support more than 5 mouse buttons" (FS#1082) 7 years ago
mousegrabber.c Clean up header includes 5 years ago
mousegrabber.h Revert "Support more than 5 mouse buttons" (FS#1082) 7 years ago
property.c doc: fix warnings from doxygen 5 years ago
property.h Clean up header includes 5 years ago
root.c Fix some more dubious uses of globalconf.L 5 years ago
selection.c Clean up header includes 5 years ago
selection.h remove encoding=utf-8 from modelines 8 years ago
spawn.c Hide globalconf.L 5 years ago
spawn.h Clean up header includes 5 years ago
stack.c doc: fix warnings from doxygen 5 years ago
stack.h Clean up header includes 5 years ago
strut.c remove encoding=utf-8 from modelines 8 years ago
strut.h remove encoding=utf-8 from modelines 8 years ago
systray.c Hide globalconf.L 5 years ago
systray.h remove encoding=utf-8 from modelines 8 years ago
xwindow.c xwindow_shape_pixmap: Correctly handle invalid geometry 5 years ago
xwindow.h Clean up header includes 5 years ago

README.md

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.

Reporting issues

Please report any issues you may find at https://awesome.naquadah.org/bugs/ . You can submit pull requests at https://github.com/awesomeWM/awesome .