


AWESOMERC(5)               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 &#8216;aa&#8217; and will blend
       the green with the color under it.


TEXT FORMAT
       You can use Pango markup in a text string. This  allows  formating  the
       text  rendered  inside widgets. Pango markup documentation can be found
       in the Pango documentation at http://library.gnome.org/devel/pango/sta-
       ble/PangoMarkupFormat.html:   http://library.gnome.org/devel/pango/sta-
       ble/PangoMarkupFormat.html.


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


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


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



                                                                1





AWESOMERC(5)               awesomerc(5)              AWESOMERC(5)


       mailto:julien@danjou.info>.


WWW
       http://awesome.naquadah.org: http://awesome.naquadah.org




















































                                                                2


