awesome/awesomerc.5.txt

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

NAME
----

awesomerc - Configuration file for the awesome window manager

SYNOPSIS
--------
None.

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
---------------
Each function available in awesome Lua implementation is listed below.
Function named package.function are relative to the package and must be called
as is.
Function named object_type:function are objects methods and must be applied on
object with type "object_type".

include::apidocgen.txt[]

COLORS FORMAT
-------------
Colors format in *awesome* are either standard X color names
(blue, darkblue, lightred, etc) or hexadecimal formatted colors (#rrggbb).
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.

WIDGETS
-------
The current list of available widget is:

- iconbox
- graph
- progressbar
- taglist
- tasklist
- textbox

Each widget as its own set of properties, described below, that can bet modified with the set()
method.

ICONBOX
~~~~~~~
*image*::
    The image path.

*resize*::
    True if you want the image to be auto-resized.

PROGRESSBAR
~~~~~~~~~~~
A progressbar widget can contain several bars, so some properties need a data section,
that means a title for the bar. For example, if you want to feed data to the `memory' bar
you want to do mywidget:set("data", "memory 100"), where memory will be the data section.
Using a new data section name will automatically create a new bar.


The following properties require a data section before the value:

*data*::
    Feed with data.

*fg*::
    Foreground color.

*fg_off*::
    Color of unfilled area of bar.

*bg*::
    Background color (between ticks; border_padding space).

*bordercolor*::
    Border color.

*fg_center*::
    Foreground center color.

*fg_end*::
    Foreground end color.

*min_value*::
    Minimum value. This or lower values, draw a 0% bar.

*max_value*::
    Maximum value. This or higher values, draw a 100% bar.

*reverse*::
    True to draw reverse.


The following properties do not require a data section before the value and applies to all bars inside
the widget:

*gap*::
    Gap between borders.

*ticks_count*::
    The number of ticks.

*ticks_gap*::
    The gap between ticks.

*border_padding*::
    The padding inside the border.

*border_width*::
    The border width.

*width*::
    The widget width.

*height*::
    The widget height.

*vertical*::
    True if the widget is vertical.

GRAPH
~~~~~
A graph widget can display several data-graphs inside its widget-border. Some
properties need a data section, that means a title for the incoming data. For
example, if you want to feed 'memory' data, you want to do
mywidget:set("data", "memory 100").


The following properties require a data section before the value:

*data*::
    Feed with data.

*fg*::
    Foreground color.

*fg_center*::
    Foreground center color.

*fg_end*::
    Foreground end color.

*vertical_gradient*::
    If 'true', colorgradient shall be applied vertically.

*max_value*::
    Maximum value. Bigger values gets truncated, unless 'scale' is true.

*scale*::
    Scales the graph acccording to incoming values bigger than 'max_value'.

*draw_style*::
    'bottom', 'top' or 'line'.


The following properties do not require a data section before the value:

*width*::
    The widget width.

*height*::
    The widget height.

*bg*::
    Background color.

*bordercolor*::
    Border color.

*grow*::
   'left' or 'right'. E.g. 'right' means new values get added on the right of the widget.

TAGLIST
~~~~~~~
No documentation yet.

TASKLIST
~~~~~~~~
No documentation yet.

TEXTBOX
~~~~~~~
*width*::
    The widget width.

*text*::
    Text to display. You can use pango-markup e.g. <span weight='bold' foreground="#336699">...</span>
    and/or 'awesome-markup, e.g. <text align='right'>...</text>.

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

AUTHORS
-------
This man page was written by Julien Danjou <julien@danjou.info>.

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