# Change Awesome appearance

## The beautiful themes

Beautiful is where Awesome theme variables are stored.

Name | Description
--- | ---
border_marked | The border color when the client is focused
menusubmenuicon | The icon used for sub-menus
menu_height | The item height
menu_width | The default menu width
menubordercolor | The menu item border color
menuborderwidth | The menu item border width
menufgfocus | The default focused item foreground (text) color
menubgfocus | The default focused item background color
menufgnormal | The default foreground (text) color
menubgnormal | The default background color
menu_submenu | The default sub-menu indicator if no menusubmenuicon is provided
masterwidthfactor | The default master width factor
useless_gap | The default gap
gapsingleclient | Enable gaps for a single client
masterfillpolicy | The default fill policy
master_count | The default number of master windows
column_count | The default number of columns
titlebarfgnormal | The titlebar foreground (text) color
titlebarbgnormal | The titlebar background color
titlebarbgimagenormal | The titlebar background image image
titlebar_fg | The titlebar foreground (text) color
titlebar_bg | The titlebar background color
titlebar_bgimage | The titlebar background image image
titlebarfgfocus | The focused titlebar foreground (text) color
titlebarbgfocus | The focused titlebar background color
titlebarbgimagefocus | The focused titlebar background image image
titlebarfloatingbutton_normal | floatingbuttonnormal
titlebarmaximizedbutton_normal | maximizedbuttonnormal
titlebarminimizebutton_normal | minimizebuttonnormal
titlebarclosebutton_normal | closebuttonnormal
titlebarontopbutton_normal | ontopbuttonnormal
titlebarstickybutton_normal | stickybuttonnormal
titlebarfloatingbutton_focus | floatingbuttonfocus
titlebarmaximizedbutton_focus | maximizedbuttonfocus
titlebarminimizebutton_focus | minimizebuttonfocus
titlebarclosebutton_focus | closebuttonfocus
titlebarontopbutton_focus | ontopbuttonfocus
titlebarstickybutton_focus | stickybuttonfocus
titlebarfloatingbuttonnormalactive | floatingbuttonnormal_active
titlebarmaximizedbuttonnormalactive | maximizedbuttonnormal_active
titlebarontopbuttonnormalactive | ontopbuttonnormal_active
titlebarstickybuttonnormalactive | stickybuttonnormal_active
titlebarfloatingbuttonfocusactive | floatingbuttonfocus_active
titlebarmaximizedbuttonfocusactive | maximizedbuttonfocus_active
titlebarontopbuttonfocusactive | ontopbuttonfocus_active
titlebarstickybuttonfocusactive | stickybuttonfocus_active
titlebarfloatingbuttonnormalinactive | floatingbuttonnormal_inactive
titlebarmaximizedbuttonnormalinactive | maximizedbuttonnormal_inactive
titlebarontopbuttonnormalinactive | ontopbuttonnormal_inactive
titlebarstickybuttonnormalinactive | stickybuttonnormal_inactive
titlebarfloatingbuttonfocusinactive | floatingbuttonfocus_inactive
titlebarmaximizedbuttonfocusinactive | maximizedbuttonfocus_inactive
titlebarontopbuttonfocusinactive | ontopbuttonfocus_inactive
titlebarstickybuttonfocusinactive | stickybuttonfocus_inactive
tooltipbordercolor | The tooltip border color
tooltip_bg | The tooltip background color
tooltip_fg | The tooltip foregound (text) color
tooltip_font | The tooltip font
tooltipborderwidth | The tooltip border width
tooltip_opacity | The tooltip opacity
tooltip_shape | The default tooltip shape
tooltip_align | The default tooltip alignment
bg_normal | The default background color
fg_normal | The default foreground (text) color
layout_cornernw | The cornernw layout layoutbox icon
layout_cornerne | The cornerne layout layoutbox icon
layout_cornersw | The cornersw layout layoutbox icon
layout_cornerse | The cornerse layout layoutbox icon
layout_fairh | The fairh layout layoutbox icon
layout_fairv | The fairv layout layoutbox icon
layout_floating | The floating layout layoutbox icon
layout_magnifier | The magnifier layout layoutbox icon
layout_max | The max layout layoutbox icon
layout_fullscreen | The fullscreen layout layoutbox icon
layout_spiral | The spiral layout layoutbox icon
layout_dwindle | The dwindle layout layoutbox icon
layout_tile | The tile layout layoutbox icon
layout_tiletop | The tile top layout layoutbox icon
layout_tilebottom | The tile bottom layout layoutbox icon
layout_tileleft | The tile left layout layoutbox icon
snap_bg | The snap outline background color
snapborderwidth | The snap outline width
snap_shape | The snap outline shape
cursormouseresize | The resize cursor name
cursormousemove | The move cursor name
taglistfgfocus | The tag list main foreground (text) color
taglistbgfocus | The tag list main background color
taglistfgurgent | The tag list urgent elements foreground (text) color
taglistbgurgent | The tag list urgent elements background color
taglistbgoccupied | The tag list occupied elements background color
taglistfgoccupied | The tag list occupied elements foreground (text) color
taglistbgempty | The tag list empty elements background color
taglistfgempty | The tag list empty elements foreground (text) color
taglistsquaressel | The selected elements background image
taglistsquaresunsel | The unselected elements background image
taglistsquaressel_empty | The selected empty elements background image
taglistsquaresunsel_empty | The unselected empty elements background image
taglistsquaresresize | If the background images can be resized
taglistdisableicon | Do not display the tag icons, even if they are set
taglist_font | The taglist font
taglist_shape | The main shape used for the elements
taglistshapeborder_width | The shape elements border width
taglistshapeborder_color | The elements shape border color
taglistshapeempty | The shape used for the empty elements
taglistshapeborderwidthempty | The shape used for the empty elements border width
taglistshapebordercolorempty | The empty elements shape border color
taglistshapefocus | The shape used for the selected elements
taglistshapeborderwidthfocus | The shape used for the selected elements border width
taglistshapebordercolorfocus | The selected elements shape border color
taglistshapeurgent | The shape used for the urgent elements
taglistshapeborderwidthurgent | The shape used for the urgent elements border width
taglistshapebordercolorurgent | The urgents elements shape border color
tasklistfgnormal | The default foreground (text) color
tasklistbgnormal | The default background color
tasklistfgfocus | The focused client foreground (text) color
tasklistbgfocus | The focused client background color
tasklistfgurgent | The urgent clients foreground (text) color
tasklistbgurgent | The urgent clients background color
tasklistfgminimize | The minimized clients foreground (text) color
tasklistbgminimize | The minimized clients background color
tasklistbgimage_normal | The elements default background image
tasklistbgimage_focus | The focused client background image
tasklistbgimage_urgent | The urgent clients background image
tasklistbgimage_minimize | The minimized clients background image
tasklisttasklistdisable_icon | Disable the tasklist client icons
tasklistplaintask_name | Disable the extra tasklist client property notification icons
tasklist_font | The tasklist font
tasklist_align | The focused client alignment
tasklistfontfocus | The focused client title alignment
tasklistfontminimized | The minimized clients font
tasklistfonturgent | The urgent clients font
tasklist_spacing | The space between the tasklist elements
tasklist_shape | The default tasklist elements shape
tasklistshapeborder_width | The default tasklist elements border width
tasklistshapeborder_color | The default tasklist elements border color
tasklistshapefocus | The focused client shape
tasklistshapeborderwidthfocus | The focused client border width
tasklistshapebordercolorfocus | The focused client border color
tasklistshapeminimized | The minimized clients shape
tasklistshapeborderwidthminimized | The minimized clients border width
tasklistshapebordercolorminimized | The minimized clients border color
tasklistshapeurgent | The urgent clients shape
tasklistshapeborderwidthurgent | The urgent clients border width
tasklistshapebordercolorurgent | The urgent clients border color
font | The default font
bg_normal | The default background color
bg_focus | The default focused element background color
bg_urgent | The default urgent element background color
bg_minimize | The default minimized element background color
bg_systray | The system tray background color
fg_normal | The default focused element foreground (text) color
fg_focus | The default focused element foreground (text) color
fg_urgent | The default urgent element foreground (text) color
fg_minimize | The default minimized element foreground (text) color
useless_gap | The gap between clients
border_width | The client border width
border_normal | The default clients border width
border_focus | The focused client border width
border_marked | The marked clients border width
wallpaper | The wallpaper path
icon_theme | The icon theme name
awesome_icon | The Awesome icon path
bg_normal | The default background color
fg_normal | The default foreground (text) color
arcchartbordercolor | The progressbar border background color
arcchart_color | The progressbar foreground color
arcchartborderwidth | The progressbar border width
arcchart_paddings | The padding between the outline and the progressbar
thickness | The arc thickness
radialprogressbarbordercolor | The progressbar border background color
radialprogressbar_color | The progressbar foreground color
radialprogressbarborderwidth | The progressbar border width
radialprogressbar_paddings | The padding between the outline and the progressbar
checkboxborderwidth | The outer (unchecked area) border width
checkbox_bg | The outer (unchecked area) background color, pattern or gradient
checkboxbordercolor | The outer (unchecked area) border color
checkboxcheckborder_color | The checked part border color
checkboxcheckborder_width | The checked part border width
checkboxcheckcolor | The checked part filling color
checkbox_shape | The outer (unchecked area) shape
checkboxcheckshape | The checked part shape
checkbox_paddings | The padding between the outline and the progressbar
checkbox_color | The checkbox color
graph_bg | The graph background color
graph_fg | The graph foreground color
graphbordercolor | The graph border color
piechartbordercolor | The border color
piechartborderwidth | The pie elements border width
piechart_colors | The pie chart colors
progressbar_bg | The progressbar background color
progressbar_fg | The progressbar foreground color
progressbar_shape | The progressbar shape
progressbarbordercolor | The progressbar border color
progressbarborderwidth | The progressbar outer border width
progressbarbarshape | The progressbar inner shape
progressbarbarborder_width | The progressbar bar border width
progressbarbarborder_color | The progressbar bar border color
progressbar_margins | The progressbar margins
progressbar_paddings | The progressbar padding
sliderbarborder_width | The bar (background) border width
sliderbarborder_color | The bar (background) border color
sliderhandleborder_color | The handle border_color
sliderhandleborder_width | The handle border width
sliderhandlewidth | The handle
sliderhandlecolor |
sliderhandleshape | The handle shape
sliderbarshape | The bar (background) shape
sliderbarheight | The bar (background) height
sliderbarmargins | The bar (background) margins
sliderhandlemargins | The slider handle margins
sliderbarcolor | The bar (background) color
bg_systray | The systray background color
systrayiconspacing | The systray icon spacing
font | The textbox font

## Sample theme file

    local theme = {}

    -- Default variables
    -- theme.border_marked = nil
    -- theme.useless_gap = nil
    -- theme.bg_normal = nil
    -- theme.fg_normal = nil
    -- theme.font = nil
    -- theme.bg_normal = nil
    -- theme.bg_focus = nil
    -- theme.bg_urgent = nil
    -- theme.bg_minimize = nil
    -- theme.bg_systray = nil
    -- theme.fg_normal = nil
    -- theme.fg_focus = nil
    -- theme.fg_urgent = nil
    -- theme.fg_minimize = nil
    -- theme.useless_gap = nil
    -- theme.border_width = nil
    -- theme.border_normal = nil
    -- theme.border_focus = nil
    -- theme.border_marked = nil
    -- theme.wallpaper = nil
    -- theme.bg_normal = nil
    -- theme.fg_normal = nil
    -- theme.thickness = nil
    -- theme.bg_systray = nil
    -- theme.font = nil

    -- arcchart
    -- theme.arcchart_border_color = nil
    -- theme.arcchart_color = nil
    -- theme.arcchart_border_width = nil
    -- theme.arcchart_paddings = nil

    -- awesome
    -- theme.awesome_icon = nil

    -- checkbox
    -- theme.checkbox_border_width = nil
    -- theme.checkbox_bg = nil
    -- theme.checkbox_border_color = nil
    -- theme.checkbox_check_border_color = nil
    -- theme.checkbox_check_border_width = nil
    -- theme.checkbox_check_color = nil
    -- theme.checkbox_shape = nil
    -- theme.checkbox_check_shape = nil
    -- theme.checkbox_paddings = nil
    -- theme.checkbox_color = nil

    -- column
    -- theme.column_count = nil

    -- cursor
    -- theme.cursor_mouse_resize = nil
    -- theme.cursor_mouse_move = nil

    -- gap
    -- theme.gap_single_client = nil

    -- graph
    -- theme.graph_bg = nil
    -- theme.graph_fg = nil
    -- theme.graph_border_color = nil

    -- icon
    -- theme.icon_theme = nil

    -- layout
    -- theme.layout_cornernw = nil
    -- theme.layout_cornerne = nil
    -- theme.layout_cornersw = nil
    -- theme.layout_cornerse = nil
    -- theme.layout_fairh = nil
    -- theme.layout_fairv = nil
    -- theme.layout_floating = nil
    -- theme.layout_magnifier = nil
    -- theme.layout_max = nil
    -- theme.layout_fullscreen = nil
    -- theme.layout_spiral = nil
    -- theme.layout_dwindle = nil
    -- theme.layout_tile = nil
    -- theme.layout_tiletop = nil
    -- theme.layout_tilebottom = nil
    -- theme.layout_tileleft = nil

    -- master
    -- theme.master_width_factor = nil
    -- theme.master_fill_policy = nil
    -- theme.master_count = nil

    -- menu
    -- theme.menu_submenu_icon = nil
    -- theme.menu_height = nil
    -- theme.menu_width = nil
    -- theme.menu_border_color = nil
    -- theme.menu_border_width = nil
    -- theme.menu_fg_focus = nil
    -- theme.menu_bg_focus = nil
    -- theme.menu_fg_normal = nil
    -- theme.menu_bg_normal = nil
    -- theme.menu_submenu = nil

    -- piechart
    -- theme.piechart_border_color = nil
    -- theme.piechart_border_width = nil
    -- theme.piechart_colors = nil

    -- progressbar
    -- theme.progressbar_bg = nil
    -- theme.progressbar_fg = nil
    -- theme.progressbar_shape = nil
    -- theme.progressbar_border_color = nil
    -- theme.progressbar_border_width = nil
    -- theme.progressbar_bar_shape = nil
    -- theme.progressbar_bar_border_width = nil
    -- theme.progressbar_bar_border_color = nil
    -- theme.progressbar_margins = nil
    -- theme.progressbar_paddings = nil

    -- radialprogressbar
    -- theme.radialprogressbar_border_color = nil
    -- theme.radialprogressbar_color = nil
    -- theme.radialprogressbar_border_width = nil
    -- theme.radialprogressbar_paddings = nil

    -- slider
    -- theme.slider_bar_border_width = nil
    -- theme.slider_bar_border_color = nil
    -- theme.slider_handle_border_color = nil
    -- theme.slider_handle_border_width = nil
    -- theme.slider_handle_width = nil
    -- theme.slider_handle_color = nil
    -- theme.slider_handle_shape = nil
    -- theme.slider_bar_shape = nil
    -- theme.slider_bar_height = nil
    -- theme.slider_bar_margins = nil
    -- theme.slider_handle_margins = nil
    -- theme.slider_bar_color = nil

    -- snap
    -- theme.snap_bg = nil
    -- theme.snap_border_width = nil
    -- theme.snap_shape = nil

    -- systray
    -- theme.systray_icon_spacing = nil

    -- taglist
    -- theme.taglist_fg_focus = nil
    -- theme.taglist_bg_focus = nil
    -- theme.taglist_fg_urgent = nil
    -- theme.taglist_bg_urgent = nil
    -- theme.taglist_bg_occupied = nil
    -- theme.taglist_fg_occupied = nil
    -- theme.taglist_bg_empty = nil
    -- theme.taglist_fg_empty = nil
    -- theme.taglist_squares_sel = nil
    -- theme.taglist_squares_unsel = nil
    -- theme.taglist_squares_sel_empty = nil
    -- theme.taglist_squares_unsel_empty = nil
    -- theme.taglist_squares_resize = nil
    -- theme.taglist_disable_icon = nil
    -- theme.taglist_font = nil
    -- theme.taglist_shape = nil
    -- theme.taglist_shape_border_width = nil
    -- theme.taglist_shape_border_color = nil
    -- theme.taglist_shape_empty = nil
    -- theme.taglist_shape_border_width_empty = nil
    -- theme.taglist_shape_border_color_empty = nil
    -- theme.taglist_shape_focus = nil
    -- theme.taglist_shape_border_width_focus = nil
    -- theme.taglist_shape_border_color_focus = nil
    -- theme.taglist_shape_urgent = nil
    -- theme.taglist_shape_border_width_urgent = nil
    -- theme.taglist_shape_border_color_urgent = nil

    -- tasklist
    -- theme.tasklist_fg_normal = nil
    -- theme.tasklist_bg_normal = nil
    -- theme.tasklist_fg_focus = nil
    -- theme.tasklist_bg_focus = nil
    -- theme.tasklist_fg_urgent = nil
    -- theme.tasklist_bg_urgent = nil
    -- theme.tasklist_fg_minimize = nil
    -- theme.tasklist_bg_minimize = nil
    -- theme.tasklist_bg_image_normal = nil
    -- theme.tasklist_bg_image_focus = nil
    -- theme.tasklist_bg_image_urgent = nil
    -- theme.tasklist_bg_image_minimize = nil
    -- theme.tasklist_tasklist_disable_icon = nil
    -- theme.tasklist_plain_task_name = nil
    -- theme.tasklist_font = nil
    -- theme.tasklist_align = nil
    -- theme.tasklist_font_focus = nil
    -- theme.tasklist_font_minimized = nil
    -- theme.tasklist_font_urgent = nil
    -- theme.tasklist_spacing = nil
    -- theme.tasklist_shape = nil
    -- theme.tasklist_shape_border_width = nil
    -- theme.tasklist_shape_border_color = nil
    -- theme.tasklist_shape_focus = nil
    -- theme.tasklist_shape_border_width_focus = nil
    -- theme.tasklist_shape_border_color_focus = nil
    -- theme.tasklist_shape_minimized = nil
    -- theme.tasklist_shape_border_width_minimized = nil
    -- theme.tasklist_shape_border_color_minimized = nil
    -- theme.tasklist_shape_urgent = nil
    -- theme.tasklist_shape_border_width_urgent = nil
    -- theme.tasklist_shape_border_color_urgent = nil

    -- titlebar
    -- theme.titlebar_fg_normal = nil
    -- theme.titlebar_bg_normal = nil
    -- theme.titlebar_bgimage_normal = nil
    -- theme.titlebar_fg = nil
    -- theme.titlebar_bg = nil
    -- theme.titlebar_bgimage = nil
    -- theme.titlebar_fg_focus = nil
    -- theme.titlebar_bg_focus = nil
    -- theme.titlebar_bgimage_focus = nil
    -- theme.titlebar_floating_button_normal = nil
    -- theme.titlebar_maximized_button_normal = nil
    -- theme.titlebar_minimize_button_normal = nil
    -- theme.titlebar_close_button_normal = nil
    -- theme.titlebar_ontop_button_normal = nil
    -- theme.titlebar_sticky_button_normal = nil
    -- theme.titlebar_floating_button_focus = nil
    -- theme.titlebar_maximized_button_focus = nil
    -- theme.titlebar_minimize_button_focus = nil
    -- theme.titlebar_close_button_focus = nil
    -- theme.titlebar_ontop_button_focus = nil
    -- theme.titlebar_sticky_button_focus = nil
    -- theme.titlebar_floating_button_normal_active = nil
    -- theme.titlebar_maximized_button_normal_active = nil
    -- theme.titlebar_ontop_button_normal_active = nil
    -- theme.titlebar_sticky_button_normal_active = nil
    -- theme.titlebar_floating_button_focus_active = nil
    -- theme.titlebar_maximized_button_focus_active = nil
    -- theme.titlebar_ontop_button_focus_active = nil
    -- theme.titlebar_sticky_button_focus_active = nil
    -- theme.titlebar_floating_button_normal_inactive = nil
    -- theme.titlebar_maximized_button_normal_inactive = nil
    -- theme.titlebar_ontop_button_normal_inactive = nil
    -- theme.titlebar_sticky_button_normal_inactive = nil
    -- theme.titlebar_floating_button_focus_inactive = nil
    -- theme.titlebar_maximized_button_focus_inactive = nil
    -- theme.titlebar_ontop_button_focus_inactive = nil
    -- theme.titlebar_sticky_button_focus_inactive = nil

    -- tooltip
    -- theme.tooltip_border_color = nil
    -- theme.tooltip_bg = nil
    -- theme.tooltip_fg = nil
    -- theme.tooltip_font = nil
    -- theme.tooltip_border_width = nil
    -- theme.tooltip_opacity = nil
    -- theme.tooltip_shape = nil
    -- theme.tooltip_align = nil

    return theme

    -- vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80

generated by LDoc 1.4.6 Last updated 2017-01-20 01:17:18