# Change Awesome appearance

## The beautiful themes

Beautiful is where Awesome theme variables are stored.



Name Description
border_markedThe border color when the client is focused
layout_cornernwThe cornernw layout layoutbox icon
layout_cornerneThe cornerne layout layoutbox icon
layout_cornerswThe cornersw layout layoutbox icon
layout_cornerseThe cornerse layout layoutbox icon
layout_fairhThe fairh layout layoutbox icon
layout_fairvThe fairv layout layoutbox icon
layout_floatingThe floating layout layoutbox icon
layout_magnifierThe magnifier layout layoutbox icon
layout_maxThe max layout layoutbox icon
layout_fullscreenThe fullscreen layout layoutbox icon
layout_spiralThe spiral layout layoutbox icon
layout_dwindleThe dwindle layout layoutbox icon
layout_tileThe tile layout layoutbox icon
layout_tiletopThe tile top layout layoutbox icon
layout_tilebottomThe tile bottom layout layoutbox icon
layout_tileleftThe tile left layout layoutbox icon
snap_bgThe snap outline background color
snap_border_widthThe snap outline width
snap_shapeThe snap outline shape
cursor_mouse_resizeThe resize cursor name
cursor_mouse_moveThe move cursor name
menu_submenu_iconThe icon used for sub-menus
menu_heightThe item height
menu_widthThe default menu width
menu_border_colorThe menu item border color
menu_border_widthThe menu item border width
menu_fg_focusThe default focused item foreground (text) color
menu_bg_focusThe default focused item background color
menu_fg_normalThe default foreground (text) color
menu_bg_normalThe default background color
menu_submenuThe default sub-menu indicator if no menu_submenu_icon is provided
taglist_fg_focusThe tag list main foreground (text) color
taglist_bg_focusThe tag list main background color
taglist_fg_urgentThe tag list urgent elements foreground (text) color
taglist_bg_urgentThe tag list urgent elements background color
taglist_bg_occupiedThe tag list occupied elements background color
taglist_fg_occupiedThe tag list occupied elements foreground (text) color
taglist_bg_emptyThe tag list empty elements background color
taglist_fg_emptyThe tag list empty elements foreground (text) color
taglist_squares_selThe selected elements background image
taglist_squares_unselThe unselected elements background image
taglist_squares_sel_emptyThe selected empty elements background image
taglist_squares_unsel_emptyThe unselected empty elements background image
taglist_squares_resizeIf the background images can be resized
taglist_disable_iconDo not display the tag icons, even if they are set
taglist_fontThe taglist font
taglist_shapeThe main shape used for the elements
taglist_shape_border_widthThe shape elements border width
taglist_shape_border_colorThe elements shape border color
taglist_shape_emptyThe shape used for the empty elements
taglist_shape_border_width_emptyThe shape used for the empty elements border width
taglist_shape_border_color_emptyThe empty elements shape border color
taglist_shape_focusThe shape used for the selected elements
taglist_shape_border_width_focusThe shape used for the selected elements border width
taglist_shape_border_color_focusThe selected elements shape border color
taglist_shape_urgentThe shape used for the urgent elements
taglist_shape_border_width_urgentThe shape used for the urgent elements border width
taglist_shape_border_color_urgentThe urgents elements shape border color
tasklist_fg_normalThe default foreground (text) color
tasklist_bg_normalThe default background color
tasklist_fg_focusThe focused client foreground (text) color
tasklist_bg_focusThe focused client background color
tasklist_fg_urgentThe urgent clients foreground (text) color
tasklist_bg_urgentThe urgent clients background color
tasklist_fg_minimizeThe minimized clients foreground (text) color
tasklist_bg_minimizeThe minimized clients background color
tasklist_bg_image_normalThe elements default background image
tasklist_bg_image_focusThe focused client background image
tasklist_bg_image_urgentThe urgent clients background image
tasklist_bg_image_minimizeThe minimized clients background image
tasklist_tasklist_disable_iconDisable the tasklist client icons
tasklist_plain_task_nameDisable the extra tasklist client property notification icons
tasklist_fontThe tasklist font
tasklist_alignThe focused client alignment
tasklist_font_focusThe focused client title alignment
tasklist_font_minimizedThe minimized clients font
tasklist_font_urgentThe urgent clients font
tasklist_spacingThe space between the tasklist elements
tasklist_shapeThe default tasklist elements shape
tasklist_shape_border_widthThe default tasklist elements border width
tasklist_shape_border_colorThe default tasklist elements border color
tasklist_shape_focusThe focused client shape
tasklist_shape_border_width_focusThe focused client border width
tasklist_shape_border_color_focusThe focused client border color
tasklist_shape_minimizedThe minimized clients shape
tasklist_shape_border_width_minimizedThe minimized clients border width
tasklist_shape_border_color_minimizedThe minimized clients border color
tasklist_shape_urgentThe urgent clients shape
tasklist_shape_border_width_urgentThe urgent clients border width
tasklist_shape_border_color_urgentThe urgent clients border color
master_width_factorThe default master width factor
useless_gapThe default gap
gap_single_clientEnable gaps for a single client
master_fill_policyThe default fill policy
master_countThe default number of master windows
column_countThe default number of columns
titlebar_fg_normalThe titlebar foreground (text) color
titlebar_bg_normalThe titlebar background color
titlebar_bgimage_normalThe titlebar background image image
titlebar_fgThe titlebar foreground (text) color
titlebar_bgThe titlebar background color
titlebar_bgimageThe titlebar background image image
titlebar_fg_focusThe focused titlebar foreground (text) color
titlebar_bg_focusThe focused titlebar background color
titlebar_bgimage_focusThe focused titlebar background image image
titlebar_floating_button_normalfloating_button_normal
titlebar_maximized_button_normalmaximized_button_normal
titlebar_minimize_button_normalminimize_button_normal
titlebar_close_button_normalclose_button_normal
titlebar_ontop_button_normalontop_button_normal
titlebar_sticky_button_normalsticky_button_normal
titlebar_floating_button_focusfloating_button_focus
titlebar_maximized_button_focusmaximized_button_focus
titlebar_minimize_button_focusminimize_button_focus
titlebar_close_button_focusclose_button_focus
titlebar_ontop_button_focusontop_button_focus
titlebar_sticky_button_focussticky_button_focus
titlebar_floating_button_normal_activefloating_button_normal_active
titlebar_maximized_button_normal_activemaximized_button_normal_active
titlebar_ontop_button_normal_activeontop_button_normal_active
titlebar_sticky_button_normal_activesticky_button_normal_active
titlebar_floating_button_focus_activefloating_button_focus_active
titlebar_maximized_button_focus_activemaximized_button_focus_active
titlebar_ontop_button_focus_activeontop_button_focus_active
titlebar_sticky_button_focus_activesticky_button_focus_active
titlebar_floating_button_normal_inactivefloating_button_normal_inactive
titlebar_maximized_button_normal_inactivemaximized_button_normal_inactive
titlebar_ontop_button_normal_inactiveontop_button_normal_inactive
titlebar_sticky_button_normal_inactivesticky_button_normal_inactive
titlebar_floating_button_focus_inactivefloating_button_focus_inactive
titlebar_maximized_button_focus_inactivemaximized_button_focus_inactive
titlebar_ontop_button_focus_inactiveontop_button_focus_inactive
titlebar_sticky_button_focus_inactivesticky_button_focus_inactive
tooltip_border_colorThe tooltip border color
tooltip_bgThe tooltip background color
tooltip_fgThe tooltip foregound (text) color
tooltip_fontThe tooltip font
tooltip_border_widthThe tooltip border width
tooltip_opacityThe tooltip opacity
tooltip_shapeThe default tooltip shape
tooltip_alignThe default tooltip alignment
bg_normalThe default background color
fg_normalThe default foreground (text) color
fontThe default font
bg_normalThe default background color
bg_focusThe default focused element background color
bg_urgentThe default urgent element background color
bg_minimizeThe default minimized element background color
bg_systrayThe system tray background color
fg_normalThe default focused element foreground (text) color
fg_focusThe default focused element foreground (text) color
fg_urgentThe default urgent element foreground (text) color
fg_minimizeThe default minimized element foreground (text) color
useless_gapThe gap between clients
border_widthThe client border width
border_normalThe default clients border width
border_focusThe focused client border width
border_markedThe marked clients border width
wallpaperThe wallpaper path
icon_themeThe icon theme name
awesome_iconThe Awesome icon path
arcchart_border_colorThe progressbar border background color
arcchart_colorThe progressbar foreground color
arcchart_border_widthThe progressbar border width
arcchart_paddingsThe padding between the outline and the progressbar
thicknessThe arc thickness
radialprogressbar_border_colorThe progressbar border background color
radialprogressbar_colorThe progressbar foreground color
radialprogressbar_border_widthThe progressbar border width
radialprogressbar_paddingsThe padding between the outline and the progressbar
bg_normalThe default background color
fg_normalThe default foreground (text) color
checkbox_border_widthThe outer (unchecked area) border width
checkbox_bgThe outer (unchecked area) background color, pattern or gradient
checkbox_border_colorThe outer (unchecked area) border color
checkbox_check_border_colorThe checked part border color
checkbox_check_border_widthThe checked part border width
checkbox_check_colorThe checked part filling color
checkbox_shapeThe outer (unchecked area) shape
checkbox_check_shapeThe checked part shape
checkbox_paddingsThe padding between the outline and the progressbar
checkbox_colorThe checkbox color
graph_bgThe graph background color
graph_fgThe graph foreground color
graph_border_colorThe graph border color
piechart_border_colorThe border color
piechart_border_widthThe pie elements border width
piechart_colorsThe pie chart colors
progressbar_bgThe progressbar background color
progressbar_fgThe progressbar foreground color
progressbar_shapeThe progressbar shape
progressbar_border_colorThe progressbar border color
progressbar_border_widthThe progressbar outer border width
progressbar_bar_shapeThe progressbar inner shape
progressbar_bar_border_widthThe progressbar bar border width
progressbar_bar_border_colorThe progressbar bar border color
progressbar_marginsThe progressbar margins
progressbar_paddingsThe progressbar padding
slider_bar_border_widthThe bar (background) border width
slider_bar_border_colorThe bar (background) border color
slider_handle_border_colorThe handle border_color
slider_handle_border_widthThe handle border width
slider_handle_widthThe handle
slider_handle_color
slider_handle_shapeThe handle shape
slider_bar_shapeThe bar (background) shape
slider_bar_heightThe bar (background) height
slider_bar_marginsThe bar (background) margins
slider_handle_marginsThe slider handle margins
slider_bar_colorThe bar (background) color
bg_systrayThe systray background color
systray_icon_spacingThe systray icon spacing
fontThe 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.thickness = nil -- theme.bg_normal = nil -- theme.fg_normal = 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.2