Welcome to the my awesome config wiki!

Modules Overview

The Configuration is modularized into several Lua packages.

Module	Description
assets	custom theme assets
behavior	controls the behavior of awesome
bindings	configures the mouse and key bindings
decorations	manages wibar and desktop widgets
layouts	manages layouts
menu	configures the awesome and exit menu
screen	configures screens
tags	defines tagnames
theme	load theme and optionally overload some of its variables

Configuration

The modules can be define through the configuration file config.lua in your awesome configuration folder.

You can use the provided template to create your initial configuration file:

cd $HOME/.config/awesome
cp config.lua.tmpl config.lua

The configuration file config.lua defines parameters like your default applications, modkeys, the look & feel of awesome, keybindings etc. Every parameter has a reasonable fallback value defined in rc/defaults.lua.

Without any configuration it should behave like the stock awesome rc.