AWESOMERC(5)

NAME
awesomerc - Configuration file for the 'awesome window manager'

SYNOPSIS
<section> [title]
{
    <option> = <value>
    <section> [title]
    {
        <option> = <value>
         ...
    }
    ...
}
<option> = <value>
include(file.conf)

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 is read at startup.

OPTIONS
awesomerc contains 5 global sections: screen, rules, keys, mouse and menu which are described here. All these sections contain options which may be strings, integers, floats, or even sections again.

  Base sections
This section defines global awesome options.

rules
    The rules section. This allows specific options for specific windows. This option must be a section `rules'.

menu
    Menu options. This option must be a section `menu', can be specified multiple times, must have a unique title.

screen
    The screens section. Make one for each of your screens. This option must be a section `screen', can be specified multiple times, must have a unique title.

keys
    Key bindings. This option must be a section `keys'.

mouse
    Mouse bindings. This option must be a section `mouse'.

  general
This section defines general options.

new_get_focus
    New windows get focus. This option must be a boolean value.

floating_placement
    How to dispose floating windows. Can be smart or under_mouse. This option must be string value.

new_become_master
    New windows become master windows. This option must be a boolean value.

sloppy_focus_raise
    Raise the window if it is given focus with the mouse. This option must be a boolean value.

sloppy_focus
    Enable sloppy focus, also known as focus follows mouse. This option must be a boolean value.

mwfact_lower_limit
    Lower limit for the master window size factor. This option must be a float value.

resize_hints
    Use resize hints when resizing tiled windows. Can produce gaps between windows. This option must be a boolean value.

snap
    The number of pixels to snap when moving floating windows. This option must be an integer value.

border
    The border size of windows in pixels. This option must be an integer value.

mwfact_upper_limit
    Upper limit for the master window size factor. This option must be a float value.

opacity_focused
    Opacity of windows when focused. This option must be a float value.

opacity_unfocused
    Opacity of windows when unfocused. This option must be a float value.

  key
This section defines a global key binding.

arg Argument to use for command. This option must be string value.

command
    Uicb command to run. This option must be string value.

key Key to press. This option must be string value.

modkey
    Modifier keys. This option must be string list.

  keylist
This section defines keylist options.

keylist
    List of keys, order matters. This option must be string list.

arglist
    List of arguments for command, order matters. This option must be string list.

command
    Uicb command to run. This option must be string value.

modkey
    Modifier keys. This option must be string list.

  keys
This section defines keys options.

keylist
    A list of key bindings. This option must be a section `keylist', can be specified multiple times.

key A key binding. This option must be a section `key', can be specified multiple times.

  layout
This section defines layout options.

image
    Image to represent layout in layoutinfo widget. This option must be string value.

  layouts
This section defines layouts options.

layout
    Available layout(s). This option must be a section `layout', can be specified multiple times, must have a title.

  menu
This section defines menu options.

styles
    Styles to use for this menu. This option must be a section `styles'.

match_string
    String matching mode (true to complete string) This option must be a boolean value.

height
    Height of the menu. Set to 0 for auto. This option must be an integer value.

autocomplete
    Autocompletion (true or false) This option must be a boolean value.

width
    Width of the menu. Set to 0 for auto. This option must be an integer value.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

  mouse
This section defines mouse options.

client
    Mouse bindings for the clients' window. This option must be a section `mouse_generic', can be specified multiple times.

root
    Mouse bindings for the root window. This option must be a section `mouse_generic', can be specified multiple times.

titlebar
    Mouse bindings for the clients' titlebar. This option must be a section `mouse_generic', can be specified multiple times.

  mouse_generic
This section defines generic mouse bindings.

button
    Mouse button. This option must be string value.

arg Argument to use for command. This option must be string value.

command
    Uicb command to run. This option must be string value.

modkey
    Modifier keys. This option must be string list.

  mouse_taglist
This section defines mouse bindings or the taglist widget.

button
    Mouse button. This option must be string value.

command
    Uicb command to run. This option must be string value.

modkey
    Modifier keys. This option must be string list.

  padding
This section defines padding options.

top Top padding in pixels. This option must be an integer value.

right
    Right padding in pixels. This option must be an integer value.

left
    Left padding in pixels. This option must be an integer value.

bottom
    Bottom padding in pixels. This option must be an integer value.

  rule
This section defines rule options.

opacity
    Opacity for this window. This option must be a float value.

name
    Regexp to match the window against a string formatted like: class:name:title. This option must be string value.

tags
    Tags matching that regexp to tag windows with. This option must be string value.

screen
    Screen to start this window on. This option must be an integer value.

float
    Set this window floating. This option must be string value.

master
    Set this window as master. This option must be string value.

xproperty_name
    Name of the xproperty to match. This option must be string value.

titlebar
    Titlebar for this window. This option must be a section `titlebar'.

xproperty_value
    Regexp value of the xproperty above to match. This option must be string value.

icon
    Icon to use for that window. This option must be string value.

  rules
This section defines rules options.

rule
    A rule. A window can match one rule. This option must be a section `rule', can be specified multiple times.

  screen
This section defines screen options.

styles
    Styles definitions. This option must be a section `styles'.

tags
    Tags definitions. This option must be a section `tags'.

statusbar
    Statubar(s) definitions. This option must be a section `statusbar', can be specified multiple times, must have a unique title.

general
    General options. This option must be a section `general'.

padding
    Paddings definitions. This option must be a section `padding'.

layouts
    Layouts definitions. This option must be a section `layouts'.

titlebar
    Titlebar definitions. This option must be a section `titlebar'.

  statusbar
This section defines statusbar options.

tasklist
    Tasklist(s) widget(s). This option must be a section `widget_tasklist', can be specified multiple times, must have a unique title.

layoutinfo
    Layoutinfo widget(s). This option must be a section `widget', can be specified multiple times, must have a unique title.

graph
    Graph(s) widget(s). This option must be a section `widget_graph', can be specified multiple times, must have a unique title.

height
    Statusbar height. Set to 0 for auto. This option must be an integer value.

width
    Statusbar width. Set to 0 for auto. This option must be an integer value.

emptybox
    Emptybox widget(s). This option must be a section `widget_emptybox', can be specified multiple times, must have a unique title.

progressbar
    Progressbar widget(s). This option must be a section `widget_progressbar', can be specified multiple times, must have a unique title.

position
    Statusbar position. This option must be a position value.

focusicon
    Focusicon widget(s). This option must be a section `widget', can be specified multiple times, must have a unique title.

taglist
    Taglist widget(s). This option must be a section `widget_taglist', can be specified multiple times, must have a unique title.

iconbox
    Iconbox widget(s). This option must be a section `widget_iconbox', can be specified multiple times, must have a unique title.

textbox
    Textbox widget(s). This option must be a section `widget_textbox', can be specified multiple times, must have a unique title.

  style
This section defines a style.

bg  Background color. This option must be string value.

fg  Foreground color. This option must be string value.

shadow_offset
    Shadow offset in pixels. This option must be an integer value.

shadow
    Shadow color. This option must be string value.

font
    Font to use. This option must be string value.

border
    Windows border color. This option must be string value.

  styles
This section defines several styles in a row.

urgent
    Style used for windows with urgency hint. This option must be a section `style'.

focus
    Style used for the focused window. This option must be a section `style'.

normal
    Normal style. This option must be a section `style'.

  tag
This section defines tag options.

mwfact
    Default master width factor for this tag. This option must be a float value.

ncol
    Default number of window columns for this tag. This option must be an integer value.

layout
    Default layout for this tag. This option must be string value.

nmaster
    Default number of master windows for this tag. This option must be an integer value.

  tags
This section defines tags options.

tag Available tag(s). This option must be a section `tag', can be specified multiple times, must have a unique title.

  titlebar
This section defines a titlebar.

styles
    Titlebar styles. This option must be a section `styles'.

align
    Titlebar alignment around window. This option must be an alignment value.

text_align
    Text alignment. This option must be an alignment value.

height
    Titlebar height. Set to 0 for auto. This option must be an integer value.

width
    Titlebar width. Set to 0 for auto. This option must be an integer value.

position
    Titlebar position. This option must be a position value.

  widget
This section defines common widgets options.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

align
    Widget alignment. This option must be an alignment value.

mouse
    Mouse bindings. This option must be a section `mouse_generic', can be specified multiple times.

  widget_emptybox
This section defines emptybox widget options.

style
    Style to use for drawing. This option must be a section `style'.

align
    Widget alignment. This option must be an alignment value.

width
    Widget width. Set to 0 for auto. This option must be an integer value.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

mouse
    Mouse bindings. This option must be a section `mouse_generic', can be specified multiple times.

  widget_graph
This section defines graph widget options.

bordercolor
    Border color. This option must be string value.

bg  Background color. This option must be string value.

data
    Data stream. This option must be a section `widget_graph_data', can be specified multiple times, must have a unique title.

align
    Widget alignment. This option must be an alignment value.

height
    Set height (i.e. 0.9 = 90%). This option must be a float value.

width
    Widget width. Set to 0 for auto. This option must be an integer value.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

mouse
    Mouse bindings. This option must be a section `mouse_generic', can be specified multiple times.

grow
    Put new values onto the left or right. This option must be a position value.

  widget_graph_data
This section defines graph data widget options.

vertical_gradient
    fg, fg_center and fg_end define a vertical gradient. This option must be a boolean value.

fg_end
    Foreground color at the end of a bar (as gradient). This option must be string value.

draw_style
    Draw style. This option must be string value.

scale
    Scale graph when values are bigger than max. This option must be a boolean value.

max Value of a full graph. This option must be a float value.

fg_center
    Foreground color in the center of the bar (as gradient). This option must be string value.

fg  Foreground color. This option must be string value.

  widget_iconbox
This section defines iconbox widget options.

align
    Widget alignment. This option must be an alignment value.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

mouse
    Mouse bindings. This option must be a section `mouse_generic', can be specified multiple times.

image
    Image to draw. This option must be string value.

resize
    Enable automatic resize of the image. This option must be a boolean value.

  widget_progressbar
This section defines progressbar widget options.

ticks_gap
    Distance between the ticks. This option must be an integer value.

vertical
    Draw the bar(s) vertically. This option must be a boolean value.

border_padding
    Padding between border and ticks/bar. This option must be an integer value.

data
    Draws a bar for each data section. This option must be a section `widget_progressbar_data', can be specified multiple times, must have a unique title.

align
    Widget alignment. This option must be an alignment value.

gap Distance between individual bars. This option must be an integer value.

height
    Set height (i.e. 0.9 = 90%). This option must be a float value.

width
    Widget width. This option must be an integer value.

ticks_count
    Number of ticks to draw. This option must be an integer value.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

border_width
    Border width in pixels. This option must be an integer value.

mouse
    Mouse bindings. This option must be a section `mouse_generic', can be specified multiple times.

  widget_progressbar_data
This section defines graph widget options.

bordercolor
    Border color. This option must be string value.

fg_end
    Foreground color at the end of a bar (as gradient). This option must be string value.

bg  Background color. This option must be string value.

reverse
    Reverse/mirror the bar. This option must be a boolean value.

fg_off
    Foreground color of not filled bar/ticks. This option must be string value.

fg_center
    Foreground color in the center of the bar (as gradient). This option must be string value.

fg  Foreground color. This option must be string value.

  widget_taglist
This section defines taglist widget options.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

align
    Widget alignment. This option must be an alignment value.

mouse
    Mouse bindings. This option must be a section `mouse_taglist', can be specified multiple times.

  widget_tasklist
This section defines tasklist widget options

styles
    Styles to use for drawing. This option must be a section `styles'.

show_icons
    Show icons of windows. This option must be a boolean value.

show
    Which windows to show: tags, all or focus. This option must be string value.

text_align
    Text alignment. This option must be an alignment value.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

mouse
    Mouse bindings. This option must be a section `mouse_generic', can be specified multiple times.

  widget_textbox
This section defines textbox widget options.

style
    Style to use for drawing. This option must be a section `style'.

text
    Default printed text. This option must be string value.

align
    Widget alignment. This option must be an alignment value.

text_align
    Text alignment. This option must be an alignment value.

width
    Widget width. Set to 0 for auto. This option must be an integer value.

y   Y coordinate, do not set for auto. This option must be an integer value.

x   X coordinate, do not set for auto. This option must be an integer value.

mouse
    Mouse bindings. This option must be a section `mouse_generic', can be specified multiple times.

UICB FUNCTIONS
In awesome, a lot of functions are available. These functions are called uicb (User Interface Call Backs). Each function can be bound to a key shortcut or a mouse button.

  Awesome

quit
    Quit awesome. No argument needed.

  Client

client_moveresize
    Move and resize a client. Argument should be in format "x y w h" with absolute (1, 20, 300, ...) or relative (+10, -200, ...) values.

client_focusnext
    Give focus to the next visible client in the stack. No argument needed.

client_swapprev
    Swap the currently focused client with the previous visible one. No argument needed.

client_swapnext
    Swap the currently focused client with the next visible one. No argument needed.

client_togglehorizontalmax
    Toggle horizontal maximization for the focused client. No argument needed.

client_zoom
    Move the client to the master area. No argument needed.

client_toggleverticalmax
    Toggle vertical maximization for the focused client. No argument needed.

client_settrans
    Set the transparency of the selected client. Argument should be an absolut or relativ floating between 0.0 and 1.0

client_togglefloating
    Toggle the floating state of the focused client. No argument needed.

client_togglescratch
    Toggle the scratch client's visibility. No argument needed.

client_focusprev
    Give focus to the previous visible client in the stack. No argument needed.

client_kill
    Kill the currently focused client. No argument needed.

client_togglemax
    Toggle maximization state for the focused client. No argument needed.

client_setscratch
    Toggle the scratch client attribute on the focused client. No argument needed.

  Focus

focus_history
    Jump back in the focus history stack. Set arg to 0 for previous, -1 for previous of previous, etc.

focus_client_byname
    Focus one of the visible clients by its name.

  Layout

tag_setlayout
    Set the layout of the current tag. Argument must be a relative or absolute integer of available layouts.

  Mouse

client_resizemouse
    Resize the focused window with the mouse. No argument needed.

client_movemouse
    Move the focused window with the mouse. No argument needed.

  Screen

screen_focus
    Switch focus to a specified screen. Argument must be an absolute or relative screen number.

client_movetoscreen
    Move client to a screen. Argument must be an absolute or relative screen number.

  Statusbar

statusbar_toggle
    Toggle the statusbar on or off. Argument must be a statusbar name, or no argument for all statusbars.

  Tag

tag_viewprev
    View the previous tag. No argument needed.

tag_toggleview
    Toggle the visibility of a tag.

tag_create
    Create a new tag. Argument must be the tag name.

tag_viewnext
    View the next tag. No argument needed.

tag_view
    View only this tag.

client_tag
    Tag the focused client with the given tag.

client_toggletag
    Toggle a tag on the focused client.

tag_prev_selected
    View the previously selected tags. No argument needed.

  Titlebar

client_toggletitlebar
    Toggle the visibility of the focused window's titlebar. No argument needed.

  General

spawn
    Spawn another process.

restart
    Restart awesome with the current command line. No argument needed.

exec
    Execute another process, replacing the current instance of awesome.

  Widget

widget_tell
    Send commands to widgets.

EXAMPLES
More examples are available on awesome's wiki: http://awesome.naquadah.org/wiki/: http://awesome.naquadah.org/wiki/

  Simple textbox example
1. Add an include directive into ~/.awesomerc
    screen 0 { include(~/.awesome/bottom-status-bar) }
2. Create ~/.awesome/bottom-status-bar
    statusbar "bottom"
    {
        position = "bottom"
        textbox "clock" { }
    }
3. Check the configuration file for errors
    $ awesome -k
    Configuration file OK.
    Note: If you see anything other than "Configuration file OK." you have a
    typo somewhere.
4. Create ~/bin/awesome-clock
    #!/bin/sh
    while true
    do
        # if you start this from .xinitrc, the script will start before
        # awesome, and will fail.
        if [ -S ~/.awesome_ctl.0 ]; then
            while true
            do
              echo "0 widget_tell bottom clock text `date`"
              echo "" # an empty line flushes data inside awesome
              sleep 1
            done | awesome-client
        else
            sleep 1
        fi
    done
    Note: What we are saying is "awesome-client, tell the bottom status bar's
    widget named 'clock' to set it's 'text' property to date's output".
5. Make your ~/bin/awesome-clock executable
   $ chmod a+x ~/bin/awesome-clock
6. Modify ~/.xinitrc
    ~/bin/awesome-clock &
    exec awesome
7. Restart awesome
8. If you did not get what you were expecting, take a look at
   ~/.xsession-errors or the terminal where X got started.

  Simple progressbar example
1. Add an include directive into ~/.awesomerc
    screen 0 { include(~/.awesome/bottom-status-bar) }
2. Create ~/.awesome/bottom-status-bar
    statusbar "bottom"
    {
        position = "bottom"
        progressbar "diskusage"
        {
            data "disk"
            {
                bordercolor = "#006e96"
                bg          = "#000000"
                fg          = "#ff0000"
                fg_center   = "#daaf0a"
                fg_end      = "#00ff00"
            }
            width = 100
            align = "left"
        }
    }
3. Check the configuration file for errors
    $ awesome -k
    Configuration file OK.
    Note: If you see anything other than "Configuration file OK," you have a
    typo somewhere.
4. Create ~/bin/awesome-diskusage
    #!/bin/sh
    while true
    do
        # if you start this from .xinitrc, the script will start before
        # awesome, and will fail.
        if [ -S ~/.awesome_ctl.0 ]; then
            while true; do
                usage = `df /dev/sda5 | awk '/\/dev\/sda5/ { print 100-$5 }'`
                echo "0 widget_tell bottom diskusage data disk ${usage}"
                echo "" # an empty line flushes data inside awesome
                sleep 600;
            done | awesome-client
        else
            sleep 1
        fi
    done
    Note: What we are saying is "awesome-client, tell the bottom status bar's
    widget named 'diskusage' to set it's 'data' property named 'disk' to
    ${usage}."
5. Make ~/bin/awesome-diskusage executable
$ chmod a+x ~/bin/awesome-diskusage
6. Modify ~/.xinitrc
    ~/bin/awesome-diskusage &
    exec awesome
7. Restart awesome
8. If you did not get what you were expecting, take a look at
   ~/.xsession-errors or the terminal where X got started.

AWESOMERC SKELETON
The following skeleton lists all available configuration options in awesomerc.
Note: when there is no whitespace, quotes are optional.
    <boolean>       -> true or false
    <color>         -> Color in X format or hexadecimal (e.g. #aabbcc)
    <float>         -> Floating numbers (e.g 0.2)
    <font>          -> Pango font: [FAMILY-LIST] [STYLE-OPTIONS] [SIZE] (e.g Sans Italic 12)
    <identifier>    -> A name used to identify (e.g foobar)
    <image>         -> A path to an image (e.g. /home/user/image.jpg)
    <integer>       -> A signed integer
    <key>           -> A KeySym (e.g. F10) or a KeyCodea (e.g #120)
    <mod>           -> A key modifier list (e.g. Mod1)
    <regex>         -> Regular expression
    <string>        -> A string
    <string-list>   -> A string list (e.g. {a, b, c, ...})
    <uicb-arg>      -> Argument to an uicb function
    <uicb-cmd>      -> Uicb function, see UICB FUNCTIONS
    <style section> -> A style section: {fg= bg= border= font= shadow= shadow_offset= }
    <{.., ...}>     -> List of available options
    [MULTI]         -> This item can be defined multiple times
screen <identifier> [MULTI]
{
    general
    {
        border = <integer>
        snap = <integer>
        resize_hints = <boolean>
        sloppy_focus = <boolean>
        sloppy_focus_raise = <boolean>
        new_become_master = <boolean>
        new_get_focus = <boolean>
        opacity_unfocused = <float>
        opacity_focused = <float>
        floating_placement = <{smart,under_mouse}>
        mwfact_lower_limit = <float>
        mwfact_upper_limit = <float>
    }
    titlebar
    {
        position = <{top, bottom, left, right, auto, off}>
        align = <{auto, left, right}>
        width = <integer>
        height = <integer>
        text_align = <{left, center, right}>
        styles
        {
            normal
            {
                <style section>
            }
            focus
            {
                <style section>
            }
            urgent
            {
                <style section>
            }
        }
    }
    statusbar <identifier> [MULTI]
    {
        position = <{top, bottom, left, right, auto, off}>
        height = <integer>
        width = <integer>
        textbox <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            align = <{auto, left, right}>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
                arg = <uicb-arg>
            }
            width = <integer>
            text = <string>
            text_align = <{left, center, right}>
            style
            {
                <style section>
            }
        }
        emptybox <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            align = <{auto, left, right}>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
                arg = <uicb-arg>
            }
            width = <integer>
            style
            {
                <style section>
            }
        }
        taglist <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            align = <{auto, left, right}>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
            }
        }
        layoutinfo <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            align = <{auto, left, right}>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
                arg = <uicb-arg>
            }
        }
        iconbox <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            align = <{auto, left, right}>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
                arg = <uicb-arg>
            }
            image = <image>
            resize = <boolean>
        }
        focusicon <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            align = <{auto, left, right}>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
                arg = <uicb-arg>
            }
        }
        progressbar <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            align = <{auto, left, right}>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
                arg = <uicb-arg>
            }
            data <identifier> [MULTI]
            {
                fg = <color>
                fg_center = <color>
                fg_end = <color>
                fg_off = <color>
                bg = <color>
                bordercolor = <color>
                reverse = <boolean>
            }
            width = <integer>
            gap = <integer>
            border_width = <integer>
            border_padding = <integer>
            ticks_gap = <integer>
            ticks_count = <integer>
            height = <float>
            vertical = <boolean>
        }
        graph <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            align = <{auto, left, right}>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
                arg = <uicb-arg>
            }
            data <identifier> [MULTI]
            {
                max = <float>
                scale = <boolean>
                fg = <color>
                fg_center = <color>
                fg_end = <color>
                vertical_gradient = <boolean>
                draw_style = <{bottom, top, line}>
            }
            width = <integer>
            grow = <{left, right}>
            height = <float>
            bg = <color>
            bordercolor = <color>
        }
        tasklist <identifier> [MULTI]
        {
            x = <integer>
            y = <integer>
            mouse [MULTI]
            {
                modkey = <mod>
                button = <string>
                command = <uicb-cmd>
                arg = <uicb-arg>
            }
            styles
            {
                normal
                {
                    <style section>
                }
                focus
                {
                    <style section>
                }
                urgent
                {
                    <style section>
                }
            }
            text_align = <{left, center, right}>
            show = <{all,tags,focus}>
            show_icons = <boolean>
        }
    }
    tags
    {
        tag <identifier> [MULTI]
        {
            layout = <string>
            mwfact = <float>
            nmaster = <integer>
            ncol = <integer>
        }
    }
    styles
    {
        normal
        {
            <style section>
        }
        focus
        {
            <style section>
        }
        urgent
        {
            <style section>
        }
    }
    layouts
    {
        layout <title> [MULTI]
        {
            image = <image>
        }
    }
    padding
    {
        top = <integer>
        bottom = <integer>
        right = <integer>
        left = <integer>
    }
}
rules
{
    rule [MULTI]
    {
        xproperty_name = <string>
        xproperty_value = <regex>
        name = <regex>
        tags = <regex>
        icon = <string>
        float = <{auto,true,false}>
        master = <{auto,true,false}>
        titlebar
        {
            position = <{top, bottom, left, right, auto, off}>
            align = <{auto, left, right}>
            width = <integer>
            height = <integer>
            text_align = <{left, center, right}>
            styles
            {
                normal
                {
                    <style section>
                }
                focus
                {
                    <style section>
                }
                urgent
                {
                    <style section>
                }
            }
        }
        screen = <integer>
        opacity = <float>
    }
}
keys
{
    key [MULTI]
    {
        modkey = <mod>
        key = <key>
        command = <uicb-cmd>
        arg = <uicb-arg>
    }
    keylist [MULTI]
    {
        modkey = <mod>
        keylist = <key, ...>
        command = <uicb-cmd>
        arglist = <string-list>
    }
}
mouse
{
    root [MULTI]
    {
        modkey = <mod>
        button = <string>
        command = <uicb-cmd>
        arg = <uicb-arg>
    }
    client [MULTI]
    {
        modkey = <mod>
        button = <string>
        command = <uicb-cmd>
        arg = <uicb-arg>
    }
    titlebar [MULTI]
    {
        modkey = <mod>
        button = <string>
        command = <uicb-cmd>
        arg = <uicb-arg>
    }
}
menu <identifier> [MULTI]
{
    width = <integer>
    height = <integer>
    x = <integer>
    y = <integer>
    match_string = <boolean>
    autocomplete = <boolean>
    styles
    {
        normal
        {
            <style section>
        }
        focus
        {
            <style section>
        }
        urgent
        {
            <style section>
        }
    }
}

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

AUTHORS
This man page was written by Julien Danjou <julien@danjou.info: mailto:julien@danjou.info>, Marco Candrian <mac@calmar.ws: mailto:mac@calmar.ws> and Chris Ciulla <chris.ciulla@gmail.com: mailto:chris.ciulla@gmail.com> (Simple Examples).

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