[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

This is an old revision of the document!


awesome Dynamic Window Manager

awesome is a highly configurable, next generation framework window manager for X. It is very fast, extensible and licensed under the GNU GPLv2 license.
It is primarly targeted at power users, developers and any people dealing with every day computing tasks and who want to have fine-grained control on theirs graphical environment.

awesome on Slackware

Slackware does not come with awesome Window Manager. You will need to add it manually.

Dependencies

Install the following dependencies

note: lua is dependency for lgi

Installation

Download the slackbuild from SlackBuilds.org.
Build and install the package.

Configuration

awesome do not create configuration file automatically, so you will need to do it manually.

  1. $ mkdir -p ~/.config/awesome/
  2. $ cp /etc/xdg/awesome/rc.lua ~/.config/awesome/

awesome is using LUA scripting language for configuration.
In order to customize awesome to your liking, you will need to edit your config file accordingly.
Some examples for customizations:

  • modkey (modifier key - line 53) - popular values: Mod4/Mod1 (Windows/Alt key), default: Mod4
  • terminal (default terminal - line 44) - default: xterm

For explanation on how to configure awesome check this wiki article: awesome.naquadah.org/wiki/Awesome_3_configuration

Starting awesome

Exit X server and run xwmconfig. Choose awesome from the menu and run startx to start X server again.

Links

Sources

 howtos:window_managers:awesome ()