Attention

Qubes OS 4.2 has reached end of life - it is no longer supported and thus will no longer receive security updates, bug fixes, or new features. We recommend to perform an in-place upgrade or perform a clean installation of Qubes 4.3! The documentation of version 4.2 will also not receive any new updates, unless bug fixes. Its state is thus archived.

AwesomeWM (window manager)

Warning

This page is intended for advanced users.

Qubes-specific features

  • support for the Qubes OS window colors

  • rudimentary support for the Qubes application menu entries following the freedesktop standard

  • support for custom filters and menu entries

Installation

AwesomeWM can be installed with the standard dom0 installation mechanisms.

$ sudo qubes-dom0-update awesome

That’s it. After logging out, you can select AwesomeWM in the login manager.

Development

To contribute code you may clone the AwesomeWM repository as follows:

$ git clone https://github.com/QubesOS/qubes-desktop-linux-awesome

For build instructions please check the repository README.

The repository attempts to follow the upstream Fedora repository.