Provided by: awesome_2.3.4-1_i386 bug

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.

       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/

   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>
               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>, Marco
       Candrian <mac@calmar.ws> and Chris Ciulla <chris.ciulla@gmail.com>
       (Simple Examples).

WWW

       http://awesome.naquadah.org

                                  11/10/2008                      AWESOMERC(5)