AWESOMERC(5)                                                      AWESOMERC(5)

NAME
       awesomerc - Configuration file for the awesome window manager

SYNOPSIS
       awesome looks for a configuration file in this order:

       o   $XDG_CONFIG_HOME/awesome/rc.lua

       o   $HOME/.config/awesome/rc.lua

       o   $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
       <http://library.gnome.org/devel/pango/stable/PangoMarkupFormat.html>.

       A Pango markup example: <span weight="bold"
       foreground="#336699">...</span>.

SEE ALSO
       awesome(1) awesome-client(1)

AUTHORS
       Written by Julien Danjou  <julien@danjou.info>.

WWW
        <https://awesomewm.org>

                                  2024-07-04                      AWESOMERC(5)