GitHub logo awesomeWM / awesome

awesome window manager


About Awesome

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 either install via make install:

make install  # you might need root permissions

or by auto-generating a .deb or .rpm package, for easy removal later on:

make package
sudo dpkg -i awesome-x.y.z.deb
# or
sudo rpm -Uvh awesome-x.y.z.rpm

NOTE: Awesome uses cmake to build. In case you want to pass arguments to cmake, please use the CMAKE_ARGS environment variable. For instance:


Installing current git master as a package receipts

Arch Linux AUR

sudo pacman -S --needed base-devel git
git clone
cd awesome-git
makepkg -fsri


sudo apt build-dep awesome
git clone
cd awesome
make package
sudo apt install *.deb


View on GitHub