--- name: "awesomerc" section: "5" platform: "linux" package: "awesome" version: "4.3-7" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/awesomerc" --- # awesomerc(5) Configuration file for the awesome window manager ## NAME awesomerc - Configuration file for the awesome window manager ## SYNOPSIS **awesome** looks for a configuration file in this order: • $XDG\_CONFIG\_HOME/awesome/rc.lua • $HOME/.config/awesome/rc.lua • $XDG\_CONFIG\_DIRS/awesome/rc.lua ## DESCRIPTION The **rc.lua** file contains configuration information for **awesome**. It can be used to configure the behavior and look of awesome in a variety of ways. It can be assimilated as a Lua program/script run at startup by **awesome**. Therefore, it should use the awesome Lua API described in the API section. This file is read at startup. ## AWESOME LUA API Documentation for the Lua API can be found in the luadoc directory. ## COLORS FORMAT The color format in **awesome** is either a standard X color name (blue, darkblue, lightred, etc) or a hexadecimal formatted color (#rrggbb or #rrggbbaa). By using the hexadecimal format, you can also specify an alpha channel: that means that #00ff00 will draw pure green, but #00ff00aa will set the alpha channel to ‘aa’ and will blend the green with the color under it. ## TEXT FORMAT You can use Pango markup in a text string. This allows formatting the text rendered inside widgets. Pango markup documentation can be found in the Pango documentation at \. A Pango markup example: \...\. ## SEE ALSO [awesome(1)](/awesome/1.md) [awesome-client(1)](/awesome-client/1.md) ## AUTHORS Written by Julien Danjou \. ## WWW \