awesome/awesomerc.5.txt

awesomerc(5)
===========

NAME
----

awesomerc - Configuration file for the awesome window manager

SYNOPSIS
--------
*awesome* looks for this configuration file in this order:

* $XDG_CONFIG_HOME/awesome/rc.lua
* $HOME/.config/awesome/rc.lua
* XDG_CONFIG_DIRS/awesome/rc.lua

DESCRIPTION
-----------
The *awesomerc* file contains configuration informations for *awesome*. It can
be used to configure the behaviour 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
-------------
Colors format in *awesome* are either standard X color names
(blue, darkblue, lightred, etc) or hexadecimal formatted colors (#rrggbb
or #rrggbbaa).
By using hexadecimal format, you can also specifies 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 and mix Pango markup and awesome markup in text string.
This allows to format the text rendered in widgets.
Pango markup documentation can be found in the Pango documentation at
http://library.gnome.org/devel/pango/stable/PangoMarkupFormat.html.

List of awesome markup elements and their attributes:

* bg
  - color: background color
  - image: background image
  - align: background image alignment
  - resize: resize background image to text size
* border
  - color: border color
  - width: border width
* margin
  - left: left margin in pixel
  - right: right margin in pixel
  - top: top margin in pixel
* text
  - align: text alignment
  - shadow: shadow color
  - shadow_offset: shadow color offset in pixel


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

An awesome markup example: <text align="right"/>.

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

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

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