|Original author(s)||Julien Danjou|
|Initial release||September 18, 2007|
4.3 / 28 January 2019
|Written in||C and Lua|
AwesomeWM is a dynamic window manager for the X Window System developed in the C and Lua programming languages. Lua is also used for configuring and extending the window manager. Its development began as a fork of dwm. It aims to be extremely small and fast, yet extensively customizable. It makes it possible for the user to manage windows with the use of keyboard.
The fork was initially nicknamed jdwm, where "jd" denoted the principal programmer's initials and dwm denoted the software project it was forked from. The first git repository for what was to become awesome was set up in September 2007. jdwm was renamed to awesome, named after the same phrase used by the How I Met Your Mother character Barney Stinson. awesome was officially announced on the dwm mailing list on September 20, 2007.
A window manager is probably one of the most used software in your day-to-day tasks, with your Web browser, mail reader and text editor. Power users and programmers have a big range of choice between several tools for these day-to-day tasks. Some are heavily extensible and configurable.
awesome tries to complete these tools with what we miss: an extensible, highly configurable window manager.
Awesome has emerged as a dwm fork featuring customization through external configuration files (see Configuration and customization below). Although highly extensible, the default setup of the window manager is deliberately simplified. In doing so, the author has created what he calls a framework window manager for users to expand and adapt to their own needs.
- Configured via a Lua configuration file.
- Like dwm and wmii, awesome uses tags instead of workspaces. Windows can be assigned to several tags, and multiple tags can be selected at the same time.
- As a dynamic window manager, awesome can switch between different layouts for each tag, including floating, several dynamic tiling layouts, maximized and magnifier.
- Multiple and per screen status bars, including a variety of widgets (text and icon boxes, graphs, progress bars, and so on).
- Everything can be done with the keyboard, so usage of a mouse is optional.
- Multihead support (XRandR, Xinerama or Zaphod mode).
- Implements freedesktop.org standards including EWMH, XDG Base Directory, XEmbed, Desktop Notification and System Tray.
- Compositing and true transparency support through an external compositor such as xcompmgr.
- Remote control via D-Bus (awesome-client).
- Supports the pango markup language.
Configuration and customization
From the very beginning, awesome was conceived as a dwm fork with an external configuration file. As such, its configuration file format, and the process of configuration itself, was subject to special attention by the author.
Early configuration file formats
Prior to the third major release, one of awesome's features was what Danjou termed a 'no complicated configuration'. First versions of awesome (1.x) were simple modification of dwm with flat file configuration which used libconfig. In 2.x branch, Danjou changed the configuration library from libconfig to libconfuse, a different flat file configuration library, somewhat resembling libconfig. During the development of 2.x releases, many customization features were added to awesome, such as titlebars and icon drawing.
New configuration file
On May 20, 2008, Danjou announced in an e-mail to the awesome mailing list that a new format for the configuration file will be used in 3.0 release. The new format was placed in a file ~/.awesomerc.lua, and was later moved to ~/.config/awesome/rc.lua. As the extension suggests, the configuration file is written in the Lua programming language. Danjou argued that the new format and Lua integration would enable awesome users to customize awesome in ways he previously considered impossible: using a programming language for configuration made it possible to dynamically specify configuration options.
Themes and widgets
It is possible to theme (or skin) awesome by using the window manager's Beautiful library. In line with rc.lua configuration file, theming is also done in Lua, allowing dynamic themes to be created.
Although the default awesome configuration as of 3.2.1 release does not have any status indicators (like wireless network status, battery indicators, etc.), users can add these items using widgets. Data for the widgets is supplied using arbitrary Lua code since widgets are defined in the main configuration file.
Migration to XCB
The 3.0 version, released September 18, 2008, uses the XCB library to communicate with the X server, making awesome the first window manager to use this library instead of Xlib. Work on the XCB port was started by Arnaud Fontaine, one of the current Awesome developers, in January 2008.
Arnaud Fontaine announced the move to XCB on the XCB mailing list on April 9, 2008. In his message to the list, he emphasized the following as main advantages of using XCB: "modular architecture; direct access to the protocols; multithreading; asynchronous requests/replies;". The XCB port was completed the following month and Danjou created a new branch based on XCB.
Because of the perceived problems that limited expanding and customization in pre-3.0 version of awesome, the author decided to integrate Lua-based configuration into awesome. The rc1 of the new Lua-scriptable implementation was announced in August 2008. In September 2008, the first version of awesome with Lua API completed in parallel with XCB implementation.
Distribution package availability
awesome is distributed on a wide range of Unix-like operating systems, including Arch Linux, Debian, Fedora Linux, Gentoo, Ubuntu, Source Mage, openSUSE, Mageia, NixOS, FreeBSD, NetBSD and OpenBSD.
AwesomeWM versions 1.0 through 1.3 (September–October 2007) were not named. Starting with the first 2.0 release candidate (November 2007), awesome has used named releases. The release names are related to music. AwesomeWM v4.x uses song name from Daft Punk.
- Comparison of X window managers
- i3 (window manager)
- Ion (window manager)
- Stacking window manager
- Tiling window manager
- 1.0 release tag
- "Release 4.3". 28 January 2019. Retrieved 28 January 2019.
- "github.com/awesomeWM/awesome". GitHub. 28 April 2022.
- Danjou, Julien (20 September 2007). "Project announcement from dwm mailing list". Gmane. Archived from the original on 2009-04-06. Retrieved 2008-12-13.
- Danjou, Julien (15 April 2009). "Taking the other direction". Archived from the original on 13 July 2011. Retrieved 14 August 2011.
- "about - awesome window manager". Archived from the original on 2007-10-11. Retrieved 2016-09-06.
- awesome 3: Lua integration Archived February 10, 2009, at the Wayback Machine
- News on awesome-3 and about latest commits (May 20, 2008) Archived 22 August 2009 at the Wayback Machine
- awesome API documentation Archived 11 May 2009 at the Wayback Machine
- Awesome 3 configuration Archived 1 June 2009 at the Wayback Machine
- awesome Wiki: Beautiful Archived 30 May 2009 at the Wayback Machine
- awesome Wiki: Widgets in awesome Archived 30 May 2009 at the Wayback Machine
- XCB transition announcement from XCB mailing list Archived 27 August 2009 at the Wayback Machine
- Community page on Awesome homepage: under Developers heading Archived 23 November 2007 at the Wayback Machine
- 3.0-rc1 announcement on awesome mailing list Archived 6 May 2009 at the Wayback Machine
- "awesome package in the Arch Linux community repository".
- Debian - Details of package awesome in squeeze. Packages.debian.org. Retrieved on 2013-07-13.
- Gentoo Packages /package/x11-wm/awesome. Packages.gentoo.org (2013-04-10). Retrieved on 2013-07-13.
- "Ubuntu – Error".
- "awesome - software.opensuse.org".
- awesome Wiki: List of awesome releases Archived 5 June 2009 at the Wayback Machine
- Official website
- My first awesome - tutorial
- Falko Benthin (2008-12-01). "Herr der Fenster. Schlanker Windowmanager Awesome" [Lord of the window. Slim Awesome Window Manager]. Linux User (in German) (12/2008). ISSN 1615-4444. Retrieved 2010-03-16.
- Awesome Window Manager: How Can Your Environment Work For You? - wiki review article (in progress)
- Awesome window manager - brief blog review
- Comparison of extensible window managers - Comparison of Sawfish, Awesome, Xmonad, StumpWM, and Qtile.