# Download

## Packages

**awesome** is currently available in:

* Arch Linux:
  * [stable](https://www.archlinux.org/packages/community/x86_64/awesome/)
  * [awesome-git in AUR](https://aur.archlinux.org/packages/awesome-git)
  * [awesome-luajit-git in AUR](https://aur.archlinux.org/packages/awesome-luajit-git/)
* [Debian](http://packages.debian.org/awesome)
* [Ubuntu](http://packages.ubuntu.com/awesome)
* [Fedora](https://apps.fedoraproject.org/packages/awesome)
* [FreeBSD](http://www.freshports.org/x11-wm/awesome/)
* [Gentoo](http://packages.gentoo.org/package/x11-wm/awesome)
* [OpenBSD](http://openports.se/x11/awesome)
* [NetBSD](http://cvsweb.netbsd.org/bsdweb.cgi/pkgsrc/wm/awesome/)
* [Source Mage GNU/Linux](http://codex.sourcemage.org/test/windowmanagers/awesome/)
* [T2 SDE](http://t2-project.org/packages/awesome.html)
* [CRUX](http://crux.nu/portdb/index.php?q=awesome&a=search&s=true)
* [openSUSE](http://download.opensuse.org/repositories/X11:/windowmanagers/)
* [Milis Linux](https://notabug.org/milislinux/milis/src/master/talimatname/genel/a/awesome)
* [PLD Linux](http://pld-linux.org)
* [Mageia](http://mageia.madb.org/package/show/application/0/name/awesome)
* [OpenIndiana](http://pkg.openindiana.org/hipster/en/search.shtml?token=awesome&action=Search)

Repology provides a [comprehensive overview](https://repology.org/metapackage/awesome/versions) of which version of **awesome** is included in which distribution.

### Distributions using Awesome as the default window manager

 * [GoboLinux](https://gobolinux.org)

## Building from Source

<p class="standout">
We strongly recommend using the awesome package of your distribution.
</p>

This is because many people who tried to build from source had problems.
[LGI](https://github.com/pavouk/lgi), one of awesome's dependencies, currently
hardcodes the package search path used by Lua 5.1. Part of the reason for this
is that Lua upstream intends Lua to be embedded, which means that detecting an
installed Lua version properly is not easy.

After installing awesome, you can check if you are affected by this problem by
running `awesome -v`. If an error message is displayed instead of LGI version's
number, you are likely affected.

### Stable

Latest stable version of **awesome** is version 4.2 (*Human after all*)
released on 15 July 2017.

* [v4.2 changelog](../changelogs/v4.2.txt) ([short](../changelogs/short/v4.2.txt))
* [awesome-4.2.tar.bz2](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-4.2.tar.bz2) ([GPG sig](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-4.2.tar.bz2.asc))
* [awesome-4.2.tar.xz](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-4.2.tar.xz) ([GPG sig](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-4.2.tar.xz.asc))

### Old stable

This branch of **awesome** is deprecated.

Latest old stable version of **awesome** is version 3.5.9 (*Mighty Ravendark*)
released on 6 March 2016.

* [v3.5.9 changelog](../changelogs/v3.5.9.txt) ([short](../changelogs/short/v3.5.9.txt))
* [awesome-3.5.9.tar.bz2](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-3.5.9.tar.bz2)
* [awesome-3.5.9.tar.xz](https://github.com/awesomeWM/awesome-releases/raw/master/awesome-3.5.9.tar.xz)

### Development

The Git repository can be cloned from Github:

  `git clone https://github.com/awesomeWM/awesome.git`

Alternatively, development versions can be downloaded as ZIP files through the
[Github web interface](https://github.com/awesomeWM/awesome).

## History

A list of of old releases [[is available here|releases]].