Skip to main content
Version: 2.2 (dev)

Theme variables

The beautiful table supplies theme defaults to Lua modules. Annotations come from @beautiful LDoc tags in the SomeWM source. Source: ea3a2a1a9e. 477 documented, 88 used-but-undocumented.

See the Theme Tutorial for how to apply these in a custom theme.

Quick-Start Variables​

Common theme values. Widgets read them as defaults unless configured otherwise.

VariableTypeDescription
bg_normalcolorDefault background
fg_normalcolorDefault text
bg_focuscolorBackground when focused
fg_focuscolorText when focused
bg_urgentcolorBackground for urgent items
fg_urgentcolorText for urgent items
fontstringDefault Pango font, e.g. "sans 10"
border_widthnumberWindow border thickness in pixels
border_color_normalcolorUnfocused window border
border_color_activecolorFocused window border
useless_gapnumberGap between tiled windows
wallpaperstringPath to wallpaper image

Systray styles​

The systray reference groups all tray styles by effect, with accepted values, defaults, per-application fields and version limits. Some source annotations below describe options the renderer does not apply, including icon overrides, hover scaling and dot/ring/glow indicators. The systray reference marks those limits explicitly.

Cursors​

Standard X cursor names like "left_ptr", "fleur", "cross", "watch" are accepted.

Set the cursor theme before launching:

export XCURSOR_THEME="Adwaita"
export XCURSOR_SIZE="24"
somewm

Or change it at runtime (SomeWM-only):

root.cursor_theme("Adwaita")
root.cursor_size(32)

See cursor theming.


awful​

302 entries.

VariableTypeDescriptionSource
accessibility_cursor_finder_animated somewm-onlybooleanAnimate the locator. With false, rings follow the pointer without shrinking and cursor size changes immediately.awful/accessibility.lua:40
accessibility_cursor_finder_color somewm-onlycolorSolid ring colour.awful/accessibility.lua:58
accessibility_cursor_finder_cooldown somewm-onlynumberShake cooldown in seconds after deflation begins or the locator stops.awful/accessibility.lua:136
accessibility_cursor_finder_deflate_delay somewm-onlynumberInactivity in seconds before cursor deflation.awful/accessibility.lua:112
accessibility_cursor_finder_deflate_duration somewm-onlynumberCursor deflation duration in seconds. Zero snaps.awful/accessibility.lua:106
accessibility_cursor_finder_duration somewm-onlynumberRing duration in seconds.awful/accessibility.lua:46
accessibility_cursor_finder_effect somewm-onlystringVisual effect: rings, magnify, or both.awful/accessibility.lua:34
accessibility_cursor_finder_enabled somewm-onlybooleanAllow explicit and shake activation.awful/accessibility.lua:28
accessibility_cursor_finder_history_window somewm-onlynumberShake motion history window in seconds.awful/accessibility.lua:118
accessibility_cursor_finder_inflate_duration somewm-onlynumberCursor inflation duration in seconds. Zero snaps.awful/accessibility.lua:100
accessibility_cursor_finder_line_width somewm-onlynumberRing stroke width in logical pixels.awful/accessibility.lua:64
accessibility_cursor_finder_magnification somewm-onlynumberInitial cursor magnification factor.awful/accessibility.lua:82
accessibility_cursor_finder_max_scale somewm-onlynumberMaximum cursor magnification factor.awful/accessibility.lua:94
accessibility_cursor_finder_min_diagonal somewm-onlynumberMinimum shake bounds diagonal in logical pixels.awful/accessibility.lua:130
accessibility_cursor_finder_over_magnification somewm-onlynumberAdditional magnification per repeated activation.awful/accessibility.lua:88
accessibility_cursor_finder_radius somewm-onlynumberInitial outer ring radius in logical pixels.awful/accessibility.lua:52
accessibility_cursor_finder_ring_count somewm-onlyintegerNumber of concentric rings.awful/accessibility.lua:70
accessibility_cursor_finder_sensitivity somewm-onlynumberRequired travelled-distance to bounding-diagonal ratio.awful/accessibility.lua:124
accessibility_cursor_finder_shake_enabled somewm-onlybooleanEnable event-driven shake detection for this instance.awful/accessibility.lua:76
calendar_popup_width somewm-onlynumberThe calendar width, when the popup is created without a width. With neither, the popup follows the calendar's content.awful/widget/calendar_popup.lua:49
calendar_stylecell_propertiesThe generic calendar style table. Each table property can also be defined by beautiful.calendar_[flag]_[property]=val.awful/widget/calendar_popup.lua:43
carousel_center_mode somewm-onlystringViewport centering mode.awful/layout/suit/carousel.lua:56
carousel_default_column_width somewm-onlynumberDefault column width fraction for new columns.awful/layout/suit/carousel.lua:44
carousel_dynamic_peek_width somewm-onlynumberDynamic peek width in pixels. Columns at the edges of the strip will have this applied as their peek width. Negative values are ignored and cause edge columns to use peek_width instead.awful/layout/suit/carousel.lua:72
carousel_peek_width somewm-onlynumberPeek width in pixels for showing adjacent column edges.awful/layout/suit/carousel.lua:67
column_countintegerThe default number of columns.awful/tag.lua:1182
cursor_mouse_movestringThe move cursor name.awful/mouse/init.lua:82
cursor_mouse_resizestringThe resize cursor name.awful/mouse/init.lua:78
enable_spawn_cursorbooleanShow busy mouse cursor during spawn.awful/startup_notification.lua:23
fullscreen_hide_borderbooleanHide the border on fullscreen clients.awful/permissions/init.lua:49
gap_single_clientbooleanEnable gaps for a single client.awful/tag.lua:1009
hotkeys_bgcolorHotkeys widget background color.awful/hotkeys_popup/widget.lua:260
hotkeys_border_colorcolorHotkeys widget border color.awful/hotkeys_popup/widget.lua:272
hotkeys_border_widthintHotkeys widget border width.awful/hotkeys_popup/widget.lua:268
hotkeys_description_fontstring|lgi.Pango.FontDescriptionFont used for hotkeys' descriptions.awful/hotkeys_popup/widget.lua:301
hotkeys_fgcolorHotkeys widget foreground color.awful/hotkeys_popup/widget.lua:264
hotkeys_fontstring|lgi.Pango.FontDescriptionMain hotkeys widget font.awful/hotkeys_popup/widget.lua:297
hotkeys_group_marginintMargin between hotkeys groups.awful/hotkeys_popup/widget.lua:305
hotkeys_label_bgcolorBackground color used for miscellaneous labels of hotkeys widget.awful/hotkeys_popup/widget.lua:285
hotkeys_label_fgcolorForeground color used for hotkey groups and other labels.awful/hotkeys_popup/widget.lua:289
hotkeys_modifiers_fgcolorForeground color used for hotkey modifiers (Ctrl, Alt, Super, etc).awful/hotkeys_popup/widget.lua:281
hotkeys_override_label_bgs somewm-onlybooleanOverride label background colors instead of cycling through xresources colors.awful/hotkeys_popup/widget.lua:293
hotkeys_rows somewm-onlyintRows in one column. A longer group continues in the next column.awful/hotkeys_popup/widget.lua:309
hotkeys_shapegears.shapeHotkeys widget shape.awful/hotkeys_popup/widget.lua:276
layout_carousel somewm-onlysurfaceThe carousel layout layoutbox icon.awful/layout/suit/carousel.lua:39
layout_cornernesurfaceThe cornerne layout layoutbox icon.awful/layout/suit/corner.lua:18
layout_cornernwsurfaceThe cornernw layout layoutbox icon.awful/layout/suit/corner.lua:13
layout_cornersesurfaceThe cornerse layout layoutbox icon.awful/layout/suit/corner.lua:28
layout_cornerswsurfaceThe cornersw layout layoutbox icon.awful/layout/suit/corner.lua:23
layout_dwindlesurfaceThe dwindle layout layoutbox icon.awful/layout/suit/spiral.lua:20
layout_fairhsurfaceThe fairh layout layoutbox icon.awful/layout/suit/fair.lua:14
layout_fairvsurfaceThe fairv layout layoutbox icon.awful/layout/suit/fair.lua:19
layout_floatingsurfaceThe floating layout layoutbox icon.awful/layout/suit/floating.lua:16
layout_fullscreensurfaceThe fullscreen layout layoutbox icon.awful/layout/suit/max.lua:21
layout_magnifiersurfaceThe magnifier layout layoutbox icon.awful/layout/suit/magnifier.lua:20
layout_maxsurfaceThe max layout layoutbox icon.awful/layout/suit/max.lua:16
layout_spiralsurfaceThe spiral layout layoutbox icon.awful/layout/suit/spiral.lua:15
layout_tilesurfaceThe tile layout layoutbox icon.awful/layout/suit/tile.lua:23
layout_tilebottomsurfaceThe tile bottom layout layoutbox icon.awful/layout/suit/tile.lua:33
layout_tileleftsurfaceThe tile left layout layoutbox icon.awful/layout/suit/tile.lua:38
layout_tiletopsurfaceThe tile top layout layoutbox icon.awful/layout/suit/tile.lua:28
layoutlist_alignstringThe selected layout alignment.awful/widget/layoutlist.lua:243
layoutlist_bg_normalstring|patternThe default background color.awful/widget/layoutlist.lua:216
layoutlist_bg_selectedstring|patternThe selected layout background color.awful/widget/layoutlist.lua:226
layoutlist_disable_iconbooleanDisable the layout icons (only show the name label).awful/widget/layoutlist.lua:231
layoutlist_disable_namebooleanDisable the layout name label (only show the icon).awful/widget/layoutlist.lua:235
layoutlist_fg_normalstring|patternThe default foreground (text) color.awful/widget/layoutlist.lua:210
layoutlist_fg_selectedstring|patternThe selected layout foreground (text) color.awful/widget/layoutlist.lua:221
layoutlist_fontstringThe layoutlist font.awful/widget/layoutlist.lua:239
layoutlist_font_selectedstringThe selected layout title font.awful/widget/layoutlist.lua:247
layoutlist_shapegears.shapeThe default layoutlist elements shape.awful/widget/layoutlist.lua:255
layoutlist_shape_border_colorstring|colorThe default layoutlist elements border color.awful/widget/layoutlist.lua:263
layoutlist_shape_border_color_selectedstring|colorThe selected layout border color.awful/widget/layoutlist.lua:276
layoutlist_shape_border_widthnumberThe default layoutlist elements border width.awful/widget/layoutlist.lua:259
layoutlist_shape_border_width_selectednumberThe selected layout border width.awful/widget/layoutlist.lua:272
layoutlist_shape_selectedgears.shapeThe selected layout shape.awful/widget/layoutlist.lua:268
layoutlist_spacingnumberThe space between the layouts.awful/widget/layoutlist.lua:251
master_countintegerThe default number of master windows.awful/tag.lua:1110
master_fill_policystringThe default fill policy. ** Possible values**: * expand: Take all the space * master_width_factor: Only take the ratio defined by the master_width_factorawful/tag.lua:1052
master_width_factornumberThe default master width factorawful/tag.lua:591
maximized_hide_borderbooleanHide the border on maximized clients.awful/permissions/init.lua:53
maximized_honor_paddingbooleanHonor the screen padding when maximizing.awful/permissions/init.lua:45
menu_bg_focuscolorThe default focused item background color.awful/menu.lua:81
menu_bg_normalcolorThe default background color.awful/menu.lua:91
menu_border_colornumberThe menu item border color.awful/menu.lua:68
menu_border_widthnumberThe menu item border width.awful/menu.lua:72
menu_fg_focuscolorThe default focused item foreground (text) color.awful/menu.lua:76
menu_fg_normalcolorThe default foreground (text) color.awful/menu.lua:86
menu_fontstringThe menu text font.awful/menu.lua:55
menu_heightnumberThe item height.awful/menu.lua:60
menu_submenustringThe default sub-menu indicator if no menu_submenu_icon is provided.awful/menu.lua:96
menu_submenu_iconstring|gears.surfaceThe icon used for sub-menus.awful/menu.lua:51
menu_widthnumberThe default menu width.awful/menu.lua:64
prompt_bgcolorThe prompt background color.awful/widget/prompt.lua:18
prompt_bg_cursorcolorThe prompt cursor background color.awful/prompt.lua:102
prompt_fgcolorThe prompt foreground color.awful/widget/prompt.lua:13
prompt_fg_cursorcolorThe prompt cursor foreground color.awful/prompt.lua:97
prompt_fontstringThe prompt text font.awful/prompt.lua:107
screenshot_frame_colorcolorThe screenshot interactive frame color.awful/screenshot.lua:79
screenshot_frame_shapeshapeThe screenshot interactive frame shape.awful/screenshot.lua:83
snap_bgcolor|string|gradient|patternThe snap outline background color.awful/mouse/init.lua:62
snap_border_widthintegerThe snap outline width.awful/mouse/init.lua:66
snap_shapefunctionThe snap outline shape.awful/mouse/init.lua:70
snapper_gapnumberThe gap between snapped clients.awful/mouse/init.lua:74
taglist_bg_emptycolorThe tag list empty elements background color.awful/widget/taglist.lua:97
taglist_bg_focuscolorThe tag list main background color.awful/widget/taglist.lua:72
taglist_bg_occupiedcolorThe tag list occupied elements background color.awful/widget/taglist.lua:87
taglist_bg_urgentcolorThe tag list urgent elements background color.awful/widget/taglist.lua:82
taglist_bg_volatilecolorThe tag list volatile elements background color.awful/widget/taglist.lua:107
taglist_disable_iconbooleanDo not display the tag icons, even if they are set.awful/widget/taglist.lua:141
taglist_fg_emptycolorThe tag list empty elements foreground (text) color.awful/widget/taglist.lua:102
taglist_fg_focuscolorThe tag list main foreground (text) color.awful/widget/taglist.lua:67
taglist_fg_occupiedcolorThe tag list occupied elements foreground (text) color.awful/widget/taglist.lua:92
taglist_fg_urgentcolorThe tag list urgent elements foreground (text) color.awful/widget/taglist.lua:77
taglist_fg_volatilecolorThe tag list volatile elements foreground (text) color.awful/widget/taglist.lua:112
taglist_fontstringThe taglist font.awful/widget/taglist.lua:145
taglist_shapegears.shapeThe main shape used for the elements. This will be the fallback for state specific shapes. To get a shape for the whole taglist, use wibox.container.background.awful/widget/taglist.lua:153
taglist_shape_border_colorcolorThe elements shape border color.awful/widget/taglist.lua:169
taglist_shape_border_color_emptycolorThe empty elements shape border color.awful/widget/taglist.lua:184
taglist_shape_border_color_focuscolorThe selected elements shape border color.awful/widget/taglist.lua:199
taglist_shape_border_color_urgentcolorThe urgents elements shape border color.awful/widget/taglist.lua:214
taglist_shape_border_color_volatilecolorThe volatile elements shape border color.awful/widget/taglist.lua:229
taglist_shape_border_widthnumberThe shape elements border width.awful/widget/taglist.lua:164
taglist_shape_border_width_emptynumberThe shape used for the empty elements border width.awful/widget/taglist.lua:179
taglist_shape_border_width_focusnumberThe shape used for the selected elements border width.awful/widget/taglist.lua:194
taglist_shape_border_width_urgentnumberThe shape used for the urgent elements border width.awful/widget/taglist.lua:209
taglist_shape_border_width_volatilenumberThe shape used for the volatile elements border width.awful/widget/taglist.lua:224
taglist_shape_emptygears.shapeThe shape used for the empty elements.awful/widget/taglist.lua:174
taglist_shape_focusgears.shapeThe shape used for the selected elements.awful/widget/taglist.lua:189
taglist_shape_urgentgears.shapeThe shape used for the urgent elements.awful/widget/taglist.lua:204
taglist_shape_volatilegears.shapeThe shape used for the volatile elements.awful/widget/taglist.lua:219
taglist_spacingnumberThe space between the taglist elements.awful/widget/taglist.lua:149
taglist_squares_resizebooleanIf the background images can be resized.awful/widget/taglist.lua:137
taglist_squares_selsurfaceThe selected elements background image.awful/widget/taglist.lua:117
taglist_squares_sel_emptysurfaceThe selected empty elements background image.awful/widget/taglist.lua:127
taglist_squares_unselsurfaceThe unselected elements background image.awful/widget/taglist.lua:122
taglist_squares_unsel_emptysurfaceThe unselected empty elements background image.awful/widget/taglist.lua:132
tasklist_abovestringExtra tasklist client property notification icon for clients with the above property set.awful/widget/tasklist.lua:219
tasklist_alignstringThe focused client alignment.awful/widget/tasklist.lua:247
tasklist_belowstringExtra tasklist client property notification icon for clients with the below property set.awful/widget/tasklist.lua:223
tasklist_bg_focusstring|patternThe focused client background color.awful/widget/tasklist.lua:132
tasklist_bg_image_focusstringThe focused client background image.awful/widget/tasklist.lua:176
tasklist_bg_image_minimizestringThe minimized clients background image.awful/widget/tasklist.lua:184
tasklist_bg_image_normalstringThe elements default background image.awful/widget/tasklist.lua:172
tasklist_bg_image_urgentstringThe urgent clients background image.awful/widget/tasklist.lua:180
tasklist_bg_minimizestring|patternThe minimized clients background color.awful/widget/tasklist.lua:164
tasklist_bg_normalstring|patternThe default background color.awful/widget/tasklist.lua:116
tasklist_bg_urgentstring|patternThe urgent clients background color.awful/widget/tasklist.lua:148
tasklist_disable_iconbooleanDisable the tasklist client icons.awful/widget/tasklist.lua:188
tasklist_disable_task_namebooleanDisable the tasklist client titles.awful/widget/tasklist.lua:195
tasklist_fg_focusstring|patternThe focused client foreground (text) color.awful/widget/tasklist.lua:124
tasklist_fg_minimizestring|patternThe minimized clients foreground (text) color.awful/widget/tasklist.lua:156
tasklist_fg_normalstring|patternThe default foreground (text) color.awful/widget/tasklist.lua:108
tasklist_fg_urgentstring|patternThe urgent clients foreground (text) color.awful/widget/tasklist.lua:140
tasklist_floatingstringExtra tasklist client property notification icon for clients with the floating property set.awful/widget/tasklist.lua:227
tasklist_fontstringThe tasklist font.awful/widget/tasklist.lua:254
tasklist_font_focusstringThe focused client title alignment.awful/widget/tasklist.lua:262
tasklist_font_minimizedstringThe minimized clients font.awful/widget/tasklist.lua:270
tasklist_font_urgentstringThe urgent clients font.awful/widget/tasklist.lua:278
tasklist_icon_sizeintegerThe icon size.awful/widget/tasklist.lua:381
tasklist_maximizedstringExtra tasklist client property notification icon for clients with the maximized property set.awful/widget/tasklist.lua:231
tasklist_maximized_horizontalstringExtra tasklist client property notification icon for clients with the maximized_horizontal property set.awful/widget/tasklist.lua:235
tasklist_maximized_verticalstringExtra tasklist client property notification icon for clients with the maximized_vertical property set.awful/widget/tasklist.lua:239
tasklist_minimizedstringExtra tasklist client property notification icon for clients with the minimized property set.awful/widget/tasklist.lua:243
tasklist_ontopstringExtra tasklist client property notification icon for clients with the ontop property set.awful/widget/tasklist.lua:215
tasklist_plain_task_namebooleanDisable the extra tasklist client property notification icons. See the Status icons section for more details.awful/widget/tasklist.lua:202
tasklist_shapegears.shapeThe default tasklist elements shape.awful/widget/tasklist.lua:293
tasklist_shape_border_colorstring|colorThe default tasklist elements border color.awful/widget/tasklist.lua:307
tasklist_shape_border_color_focusstring|colorThe focused client border color.awful/widget/tasklist.lua:329
tasklist_shape_border_color_minimizedstring|colorThe minimized clients border color.awful/widget/tasklist.lua:351
tasklist_shape_border_color_urgentstring|colorThe urgent clients border color.awful/widget/tasklist.lua:373
tasklist_shape_border_widthnumberThe default tasklist elements border width.awful/widget/tasklist.lua:300
tasklist_shape_border_width_focusnumberThe focused client border width.awful/widget/tasklist.lua:322
tasklist_shape_border_width_minimizednumberThe minimized clients border width.awful/widget/tasklist.lua:344
tasklist_shape_border_width_urgentnumberThe urgent clients border width.awful/widget/tasklist.lua:366
tasklist_shape_focusgears.shapeThe focused client shape.awful/widget/tasklist.lua:315
tasklist_shape_minimizedgears.shapeThe minimized clients shape.awful/widget/tasklist.lua:337
tasklist_shape_urgentgears.shapeThe urgent clients shape.awful/widget/tasklist.lua:359
tasklist_spacingnumberThe space between the tasklist elements.awful/widget/tasklist.lua:286
tasklist_stickystringExtra tasklist client property notification icon for clients with the sticky property set.awful/widget/tasklist.lua:211
titlebar_bgcolorThe titlebar background color.awful/titlebar.lua:89
titlebar_bg_focuscolorThe focused titlebar background color.awful/titlebar.lua:107
titlebar_bg_normalcolorThe titlebar background color.awful/titlebar.lua:71
titlebar_bg_urgentcolorThe urgent titlebar background color.awful/titlebar.lua:125
titlebar_bgimagegears.surface|stringThe titlebar background image image.awful/titlebar.lua:95
titlebar_bgimage_focusgears.surface|stringThe focused titlebar background image image.awful/titlebar.lua:113
titlebar_bgimage_normalgears.surface|stringThe titlebar background image image.awful/titlebar.lua:77
titlebar_bgimage_urgentgears.surface|stringThe urgent titlebar background image.awful/titlebar.lua:131
titlebar_close_button_focusgears.surface|stringThe focused client close button image.awful/titlebar.lua:227
titlebar_close_button_focus_hovergears.surface|stringThe hovered+focused close button image.awful/titlebar.lua:233
titlebar_close_button_focus_pressgears.surface|stringThe pressed+focused close button image.awful/titlebar.lua:239
titlebar_close_button_normalgears.surface|stringThe normal close button image.awful/titlebar.lua:167
titlebar_close_button_normal_hovergears.surface|stringThe hovered close button image.awful/titlebar.lua:173
titlebar_close_button_normal_pressgears.surface|stringThe pressed close button image.awful/titlebar.lua:179
titlebar_fgcolorThe titlebar foreground (text) color.awful/titlebar.lua:83
titlebar_fg_focuscolorThe focused titlebar foreground (text) color.awful/titlebar.lua:101
titlebar_fg_normalcolorThe titlebar foreground (text) color.awful/titlebar.lua:65
titlebar_fg_urgentcolorThe urgent titlebar foreground (text) color.awful/titlebar.lua:119
titlebar_floating_button_focusgears.surface|stringThe focused client non-floating button image.awful/titlebar.lua:197
titlebar_floating_button_focus_activegears.surface|stringThe floating+focused client button image.awful/titlebar.lua:329
titlebar_floating_button_focus_active_hovergears.surface|stringThe hovered+floating+focused button image.awful/titlebar.lua:335
titlebar_floating_button_focus_active_pressgears.surface|stringThe pressed+floating+focused button image.awful/titlebar.lua:341
titlebar_floating_button_focus_inactivegears.surface|stringThe inactive+focused+floating button image.awful/titlebar.lua:473
titlebar_floating_button_focus_inactive_hovergears.surface|stringThe hovered+inactive+focused+floating button image.awful/titlebar.lua:479
titlebar_floating_button_focus_inactive_pressgears.surface|stringThe pressed+inactive+focused+floating button image.awful/titlebar.lua:485
titlebar_floating_button_normalgears.surface|stringThe normal non-floating button image.awful/titlebar.lua:137
titlebar_floating_button_normal_activegears.surface|stringThe normal floating button image.awful/titlebar.lua:257
titlebar_floating_button_normal_active_hovergears.surface|stringThe hovered floating client button image.awful/titlebar.lua:263
titlebar_floating_button_normal_active_pressgears.surface|stringThe pressed floating client button image.awful/titlebar.lua:269
titlebar_floating_button_normal_inactivegears.surface|stringThe inactive+floating button image.awful/titlebar.lua:401
titlebar_floating_button_normal_inactive_hovergears.surface|stringThe hovered+inactive+floating button image.awful/titlebar.lua:407
titlebar_floating_button_normal_inactive_pressgears.surface|stringThe pressed+inactive+floating button image.awful/titlebar.lua:413
titlebar_maximized_button_focusgears.surface|stringThe focused client non-maximized button image.awful/titlebar.lua:203
titlebar_maximized_button_focus_activegears.surface|stringThe maximized+focused button image.awful/titlebar.lua:347
titlebar_maximized_button_focus_active_hovergears.surface|stringThe hovered+maximized+focused button image.awful/titlebar.lua:353
titlebar_maximized_button_focus_active_pressgears.surface|stringThe pressed+maximized+focused button image.awful/titlebar.lua:359
titlebar_maximized_button_focus_inactivegears.surface|stringThe inactive+focused+maximized button image.awful/titlebar.lua:491
titlebar_maximized_button_focus_inactive_hovergears.surface|stringThe hovered+inactive+focused+maximized button image.awful/titlebar.lua:497
titlebar_maximized_button_focus_inactive_pressgears.surface|stringThe pressed+inactive+focused+maximized button image.awful/titlebar.lua:503
titlebar_maximized_button_normalgears.surface|stringThe normal non-maximized button image.awful/titlebar.lua:143
titlebar_maximized_button_normal_activegears.surface|stringThe maximized client button image.awful/titlebar.lua:275
titlebar_maximized_button_normal_active_hovergears.surface|stringThe hozered+maximized client button image.awful/titlebar.lua:281
titlebar_maximized_button_normal_active_pressgears.surface|stringThe pressed+maximized button image.awful/titlebar.lua:287
titlebar_maximized_button_normal_inactivegears.surface|stringThe inactive+maximized button image.awful/titlebar.lua:419
titlebar_maximized_button_normal_inactive_hovergears.surface|stringThe hovered+inactive+maximized button image.awful/titlebar.lua:425
titlebar_maximized_button_normal_inactive_pressgears.surface|stringThe pressed+maximized+inactive button image.awful/titlebar.lua:431
titlebar_minimize_button_focusgears.surface|stringThe focused client minimize button image.awful/titlebar.lua:209
titlebar_minimize_button_focus_hovergears.surface|stringThe hovered+focused client minimize button image.awful/titlebar.lua:215
titlebar_minimize_button_focus_pressgears.surface|stringThe pressed+focused minimize button image.awful/titlebar.lua:221
titlebar_minimize_button_normalgears.surface|stringThe normal minimize button image.awful/titlebar.lua:149
titlebar_minimize_button_normal_hovergears.surface|stringThe hovered minimize button image.awful/titlebar.lua:155
titlebar_minimize_button_normal_pressgears.surface|stringThe pressed minimize button image.awful/titlebar.lua:161
titlebar_ontop_button_focusgears.surface|stringThe focused client non-ontop button image.awful/titlebar.lua:245
titlebar_ontop_button_focus_activegears.surface|stringThe ontop+focused button image.awful/titlebar.lua:365
titlebar_ontop_button_focus_active_hovergears.surface|stringThe hovered+ontop+focused button image.awful/titlebar.lua:371
titlebar_ontop_button_focus_active_pressgears.surface|stringThe pressed+ontop+focused button image.awful/titlebar.lua:377
titlebar_ontop_button_focus_inactivegears.surface|stringThe inactive+focused+ontop button image.awful/titlebar.lua:509
titlebar_ontop_button_focus_inactive_hovergears.surface|stringThe hovered+inactive+focused+ontop button image.awful/titlebar.lua:515
titlebar_ontop_button_focus_inactive_pressgears.surface|stringThe pressed+inactive+focused+ontop button image.awful/titlebar.lua:521
titlebar_ontop_button_normalgears.surface|stringThe normal non-ontop button image.awful/titlebar.lua:185
titlebar_ontop_button_normal_activegears.surface|stringThe ontop button image.awful/titlebar.lua:293
titlebar_ontop_button_normal_active_hovergears.surface|stringThe hovered+ontop client button image.awful/titlebar.lua:299
titlebar_ontop_button_normal_active_pressgears.surface|stringThe pressed+ontop client button image.awful/titlebar.lua:305
titlebar_ontop_button_normal_inactivegears.surface|stringThe inactive+ontop button image.awful/titlebar.lua:437
titlebar_ontop_button_normal_inactive_hovergears.surface|stringThe hovered+inactive+ontop button image.awful/titlebar.lua:443
titlebar_ontop_button_normal_inactive_pressgears.surface|stringThe pressed+inactive+ontop button image.awful/titlebar.lua:449
titlebar_sticky_button_focusgears.surface|stringThe focused client sticky button image.awful/titlebar.lua:251
titlebar_sticky_button_focus_activegears.surface|stringThe sticky+focused button image.awful/titlebar.lua:383
titlebar_sticky_button_focus_active_hovergears.surface|stringThe hovered+sticky+focused button image.awful/titlebar.lua:389
titlebar_sticky_button_focus_active_pressgears.surface|stringThe pressed+sticky+focused button image.awful/titlebar.lua:395
titlebar_sticky_button_focus_inactivegears.surface|stringThe inactive+focused+sticky button image.awful/titlebar.lua:527
titlebar_sticky_button_focus_inactive_hovergears.surface|stringThe hovered+inactive+focused+sticky button image.awful/titlebar.lua:533
titlebar_sticky_button_focus_inactive_pressgears.surface|stringThe pressed+inactive+focused+sticky button image.awful/titlebar.lua:539
titlebar_sticky_button_normalgears.surface|stringThe normal non-sticky button image.awful/titlebar.lua:191
titlebar_sticky_button_normal_activegears.surface|stringThe sticky button image.awful/titlebar.lua:311
titlebar_sticky_button_normal_active_hovergears.surface|stringThe hovered+sticky button image.awful/titlebar.lua:317
titlebar_sticky_button_normal_active_pressgears.surface|stringThe pressed+sticky client button image.awful/titlebar.lua:323
titlebar_sticky_button_normal_inactivegears.surface|stringThe inactive+sticky button image.awful/titlebar.lua:455
titlebar_sticky_button_normal_inactive_hovergears.surface|stringThe hovered+inactive+sticky button image.awful/titlebar.lua:461
titlebar_sticky_button_normal_inactive_pressgears.surface|stringThe pressed+inactive+sticky button image.awful/titlebar.lua:467
titlebar_tooltip_alignstringThe text horizontal alignment in tooltips. It is used as the align parameter passed to the awful.tooltip constructor function. Valid values are: * "right" * "top_right" * "left" * "bottom_left" * "top_left" * "bottom" * "top"awful/titlebar.lua:619
titlebar_tooltip_delay_showintegerThe delay in second before the titlebar buttons tooltip is shown. It is used as the delay_show parameter passed to the awful.tooltip constructor function.awful/titlebar.lua:595
titlebar_tooltip_margins_leftrightintegerThe inner left and right margins for tooltip messages. It is used as the margins_leftright parameter passed to the awful.tooltip constructor function.awful/titlebar.lua:601
titlebar_tooltip_margins_topbottomintegerThe inner top and bottom margins for the tooltip messages. It is used as the margins_topbottom parameter passed to the awful.tooltip constructor function.awful/titlebar.lua:607
titlebar_tooltip_messages_closestringThe message in the close button tooltip.awful/titlebar.lua:545
titlebar_tooltip_messages_floating_activestringThe message in the floating button tooltip when then client is floating.awful/titlebar.lua:565
titlebar_tooltip_messages_floating_inactivestringThe message in the floating button tooltip when then client isn't floating.awful/titlebar.lua:570
titlebar_tooltip_messages_maximized_activestringThe message in the maximize button tooltip when the client is maximized.awful/titlebar.lua:555
titlebar_tooltip_messages_maximized_inactivestringThe message in the maximize button tooltip when the client is unmaximized.awful/titlebar.lua:560
titlebar_tooltip_messages_minimizestringThe message in the minimize button tooltip.awful/titlebar.lua:550
titlebar_tooltip_messages_ontop_activestringThe message in the onTop button tooltip when the client is onTop.awful/titlebar.lua:575
titlebar_tooltip_messages_ontop_inactivestringThe message in the onTop button tooltip when client isn't onTop.awful/titlebar.lua:580
titlebar_tooltip_messages_sticky_activestringThe message in the sticky button tooltip when the client is sticky.awful/titlebar.lua:585
titlebar_tooltip_messages_sticky_inactivestringThe message in the sticky button tooltip when the client isn't sticky.awful/titlebar.lua:590
titlebar_tooltip_timeoutnumberThe time in second before invoking the timer_function callback. It is used as the timeout parameter passed to the awful.tooltip constructor function.awful/titlebar.lua:613
tooltip_alignstringThe default tooltip alignment.awful/tooltip.lua:258
tooltip_bgcolorThe tooltip background color.awful/tooltip.lua:77
tooltip_border_colorcolorThe tooltip border color.awful/tooltip.lua:73
tooltip_border_widthnumberThe tooltip border width.awful/tooltip.lua:89
tooltip_fgcolorThe tooltip foregound (text) color.awful/tooltip.lua:81
tooltip_fontstringThe tooltip font.awful/tooltip.lua:85
tooltip_gapstableThe tooltip margins.awful/tooltip.lua:97
tooltip_opacitynumberThe tooltip opacity.awful/tooltip.lua:93
tooltip_shapegears.shapeThe default tooltip shape. The default shape for all tooltips is a rectangle. However, by setting this variable they can default to rounded rectangle or stretched octagons.awful/tooltip.lua:101
useless_gapnumberThe default gap.awful/tag.lua:957
wallpaper_bgcolorThe default wallpaper background color.awful/wallpaper.lua:315
wallpaper_fggears.colorThe default wallpaper foreground color. This is useful when using widgets or text in the wallpaper. A wallpaper created from a single image wont use this.awful/wallpaper.lua:321
wibar_alignstringThe wibar's alignments.awful/wibar.lua:168
wibar_bgcolorThe wibar's background color.awful/wibar.lua:148
wibar_bgimagesurfaceThe wibar's background image.awful/wibar.lua:152
wibar_border_colorstringThe wibar border color.awful/wibar.lua:120
wibar_border_widthintegerThe wibar border width.awful/wibar.lua:116
wibar_cursorstringThe wibar's mouse cursor.awful/wibar.lua:128
wibar_fgcolorThe wibar's foreground (text) color.awful/wibar.lua:156
wibar_heightintegerThe wibar's height.awful/wibar.lua:144
wibar_marginsnumber|tableThe wibar's margins.awful/wibar.lua:164
wibar_ontopbooleanIf the wibar is to be on top of other windows.awful/wibar.lua:124
wibar_opacitynumberThe wibar opacity, between 0 and 1.awful/wibar.lua:132
wibar_shapegears.shapeThe wibar's shape.awful/wibar.lua:160
wibar_stretchbooleanIf the wibar needs to be stretched to fill the screen.awful/wibar.lua:97
wibar_typestringThe window type (desktop, normal, dock, …).awful/wibar.lua:136
wibar_widthintegerThe wibar's width.awful/wibar.lua:140

wibox​

89 entries.

VariableTypeDescriptionSource
arcchart_bggears.colorThe radial background.wibox/container/arcchart.lua:51
arcchart_border_colorcolorThe progressbar border background color.wibox/container/arcchart.lua:23
arcchart_border_widthnumberThe progressbar border width.wibox/container/arcchart.lua:31
arcchart_colorcolorThe progressbar foreground color.wibox/container/arcchart.lua:27
arcchart_paddingstable|numberThe padding between the outline and the progressbar.wibox/container/arcchart.lua:35
arcchart_rounded_edgebooleanIf the chart has rounded edges.wibox/container/arcchart.lua:47
arcchart_start_anglenumberThe (radiant) angle where the first value start.wibox/container/arcchart.lua:55
arcchart_thicknessnumberThe arc thickness.wibox/container/arcchart.lua:43
bg_systraystringThe systray background color.wibox/widget/systray.lua:32
calendar_fontstringThe calendar font.wibox/widget/calendar.lua:46
calendar_long_weekdaysbooleanFormat the weekdays with three characters instead of twowibox/widget/calendar.lua:62
calendar_spacingnumberThe calendar spacing.wibox/widget/calendar.lua:50
calendar_start_sundaybooleanStart the week on Sunday.wibox/widget/calendar.lua:58
calendar_week_numbersbooleanDisplay the calendar week numbers.wibox/widget/calendar.lua:54
checkbox_bgcolorThe outer (unchecked area) background color, pattern or gradient.wibox/widget/checkbox.lua:29
checkbox_border_colorcolorThe outer (unchecked area) border color.wibox/widget/checkbox.lua:34
checkbox_border_widthnumberThe outer (unchecked area) border width.wibox/widget/checkbox.lua:24
checkbox_check_colornumberThe checked part filling color.wibox/widget/checkbox.lua:39
checkbox_colorcolorThe checkbox color. This will be used for the unchecked part border color and the checked part filling color. Note that check_color and border_color have priority over this property.wibox/widget/checkbox.lua:59
checkbox_paddingstable|numberThe padding between the outline and the progressbar.wibox/widget/checkbox.lua:50
checkbox_shapegears.shape|functionThe outer (unchecked area) shape.wibox/widget/checkbox.lua:44
flex_heightbooleanAllow cells to have flexible height. Flexible height allow cells to adapt their height to fill the empty space at the bottom of the widget.wibox/widget/calendar.lua:66
graph_bgcolorThe graph background color. Used, when the background_color property isn't set.wibox/widget/graph.lua:239
graph_border_colorcolorThe graph border color. Used, when the border_color property isn't set.wibox/widget/graph.lua:245
graph_fgcolorThe graph foreground color Used, when the color property isn't set.wibox/widget/graph.lua:233
piechart_border_colorcolorThe border color. If none is set, it will use current foreground (text) color.wibox/widget/piechart.lua:115
piechart_border_widthnumberThe pie elements border width.wibox/widget/piechart.lua:129
piechart_colorstableThe pie chart colors. If no color is set, only the border will be drawn. If less colors than required are set, colors will be re-used in order.wibox/widget/piechart.lua:134
progressbar_bar_border_colorcolorThe progressbar bar border color.wibox/widget/progressbar.lua:226
progressbar_bar_border_widthnumberThe progressbar bar border width.wibox/widget/progressbar.lua:221
progressbar_bar_shapegears.shapeThe progressbar inner shape.wibox/widget/progressbar.lua:215
progressbar_bgcolorThe progressbar background color.wibox/widget/progressbar.lua:189
progressbar_border_colorcolorThe progressbar border color.wibox/widget/progressbar.lua:205
progressbar_border_widthnumberThe progressbar outer border width.wibox/widget/progressbar.lua:210
progressbar_fgcolorThe progressbar foreground color.wibox/widget/progressbar.lua:194
progressbar_margins(table|number|nil)The progressbar margins. Note that if the clip is disabled, this allows the background to be smaller than the bar.wibox/widget/progressbar.lua:290
progressbar_paddings(table|number|nil)The progressbar padding. Note that if the clip is disabled, this allows the bar to be taller than the background.wibox/widget/progressbar.lua:304
progressbar_shapeshapeThe progressbar shape.wibox/widget/progressbar.lua:199
radialprogressbar_border_colorcolorThe progressbar border background color.wibox/container/radialprogressbar.lua:25
radialprogressbar_border_widthnumberThe progressbar border width.wibox/container/radialprogressbar.lua:35
radialprogressbar_colorcolorThe progressbar foreground color.wibox/container/radialprogressbar.lua:30
separator_border_colorcolorThe separator border color.wibox/widget/separator.lua:109
separator_border_widthnumberThe separator border width.wibox/widget/separator.lua:114
separator_colorcolorThe separator's color.wibox/widget/separator.lua:123
separator_shapeshapeThe separator's shape.wibox/widget/separator.lua:128
separator_span_rationumberThe relative percentage covered by the bar.wibox/widget/separator.lua:119
separator_thicknessnumberThe separator thickness.wibox/widget/separator.lua:104
slider_bar_active_colorcolorThe bar (active) color. Only works when both beautiful.slider_bar_color and beautiful.slider_bar_active_color are hex color stringswibox/widget/slider.lua:226
slider_bar_colorcolorThe bar (background) color.wibox/widget/slider.lua:221
slider_bar_heightnumberThe bar (background) height.wibox/widget/slider.lua:207
slider_bar_marginstableThe bar (background) margins.wibox/widget/slider.lua:212
slider_bar_shapegears.shapeThe bar (background) shape.wibox/widget/slider.lua:201
slider_handle_border_colorcolorThe handle border_color.wibox/widget/slider.lua:166
slider_handle_border_widthnumberThe handle border width.wibox/widget/slider.lua:171
slider_handle_colorcolorThe handle color.wibox/widget/slider.lua:181
slider_handle_cursorstringThe cursor icon while grabbing the handle. The available cursor names are:wibox/widget/slider.lua:192
slider_handle_shapegears.shapeThe handle shape.wibox/widget/slider.lua:186
slider_handle_widthnumberThe handle width.wibox/widget/slider.lua:176
systray_hover_bg somewm-onlystringThe hover background color.wibox/widget/systray_icon.lua:43
systray_hover_scale somewm-onlynumberThe hover scale factor.wibox/widget/systray_icon.lua:39
systray_icon_change_triggers_urgent somewm-onlybooleanWhether icon changes trigger urgent styling. When an app changes its icon (e.g., Slack adding a notification badge), this triggers urgent styling instead. Best used with icon_override to show a clean icon while still getting notification indicators.wibox/widget/systray_icon.lua:150
systray_icon_spacingintegerThe systray icon spacing.wibox/widget/systray.lua:42
systray_icon_style somewm-onlyfunction|tablePer-icon style overrides. Can be a function that receives the systray_item and returns a style table, or a table mapping item.id or item.app_name to style tables. Style tables can contain: - icon_override: path to custom icon - hover_scale: scale on hover - hover_bg: background color on hover - urgent_bg: background color when urgent - urgent_color: urgent indicator color - urgent_outline_color: urgent indicator outline - urgent_style: "dot", "ring", "glow", or "none" - urgent_position: "top_right", "top_left", "bottom_right", "bottom_left" - urgent_size: number, ratio if <= 1, pixels if > 1 - urgent_shape: gears.shape function (default: gears.shape.circle) - icon_change_triggers_urgent: boolean, icon changes trigger urgent - overlay_triggers_urgent: boolean, overlay presence triggers urgent styling - overlay_position: "bottom_right", "bottom_left", "top_right", "top_left" - overlay_size: number, ratio if <= 1, pixels if > 1 - overlay_bg: background color for overlay - overlay_shape: "circle", "rounded_rect", "rect" - overlay_padding: padding around overlay within backgroundwibox/widget/systray_icon.lua:47
systray_max_rowsintegerThe maximum number of rows for systray icons.wibox/widget/systray.lua:37
systray_menu_bg_focus somewm-onlystringContext menu focused background color.wibox/widget/systray_icon.lua:85
systray_menu_bg_normal somewm-onlystringContext menu background color.wibox/widget/systray_icon.lua:77
systray_menu_border_color somewm-onlystringContext menu border color.wibox/widget/systray_icon.lua:89
systray_menu_border_width somewm-onlynumberContext menu border width.wibox/widget/systray_icon.lua:93
systray_menu_callback somewm-onlyfunctionContext menu callback for customization. Called with (item, menu_items) before showing menu. Can modify menu_items.wibox/widget/systray_icon.lua:109
systray_menu_fg_focus somewm-onlystringContext menu focused foreground color.wibox/widget/systray_icon.lua:81
systray_menu_fg_normal somewm-onlystringContext menu foreground color.wibox/widget/systray_icon.lua:73
systray_menu_font somewm-onlystringContext menu font.wibox/widget/systray_icon.lua:97
systray_menu_height somewm-onlynumberContext menu height.wibox/widget/systray_icon.lua:105
systray_menu_width somewm-onlynumberContext menu width.wibox/widget/systray_icon.lua:101
systray_overlay_bg somewm-onlystringBackground color for overlay icons. Draws a background shape behind the overlay icon for better visibility.wibox/widget/systray_icon.lua:137
systray_overlay_padding somewm-onlynumberPadding around overlay icon within its background.wibox/widget/systray_icon.lua:146
systray_overlay_position somewm-onlystringThe position of overlay icons on systray items.wibox/widget/systray_icon.lua:126
systray_overlay_shape somewm-onlystringShape for overlay background.wibox/widget/systray_icon.lua:142
systray_overlay_size somewm-onlynumberThe size of overlay icons relative to the main icon. If value is <= 1, treated as a ratio (e.g., 0.33 = 33% of icon size). If value is > 1, treated as absolute pixels.wibox/widget/systray_icon.lua:131
systray_overlay_triggers_urgent somewm-onlybooleanWhether overlay presence triggers urgent styling. When true, icons with an overlay will be rendered with urgent styling even if their status is not "NeedsAttention".wibox/widget/systray_icon.lua:120
systray_paddings somewm-onlyintegerThe systray paddings (space around icons).wibox/widget/systray.lua:47
systray_show_overlay somewm-onlybooleanWhether to show overlay icons. Overlay icons are small badges displayed on top of the main icon, typically used to show status (like number of notifications).wibox/widget/systray_icon.lua:114
systray_urgent_bg somewm-onlystringThe urgent background color. Shown when the systray item status is "NeedsAttention". Similar to AwesomeWM's bg_urgent for clients/tags.wibox/widget/systray_icon.lua:21
systray_urgent_color somewm-onlystringThe urgent indicator color.wibox/widget/systray_icon.lua:27
systray_urgent_outline_color somewm-onlystringThe urgent indicator outline color.wibox/widget/systray_icon.lua:31
systray_urgent_position somewm-onlystringPosition of urgent indicators (dot style).wibox/widget/systray_icon.lua:157
systray_urgent_shape somewm-onlyfunctionShape function for urgent indicators. Used with "dot" and "ring" styles. Receives (cr, width, height).wibox/widget/systray_icon.lua:168
systray_urgent_size somewm-onlynumberSize of urgent indicator dot. If value is <= 1, treated as a ratio of icon size. If value is > 1, treated as absolute pixels.wibox/widget/systray_icon.lua:162
systray_urgent_style somewm-onlystringThe urgent indicator style.wibox/widget/systray_icon.lua:35

naughty​

47 entries.

VariableTypeDescriptionSource
notification_action_bg_normalcolorThe background color for normal actions.naughty/list/actions.lua:91
notification_action_bg_selectedcolorThe background color for selected actions.naughty/list/actions.lua:96
notification_action_bgimage_normalgears.surface|stringThe background image for normal actions.naughty/list/actions.lua:111
notification_action_bgimage_selectedgears.surface|stringThe background image for selected actions.naughty/list/actions.lua:116
notification_action_fg_normalcolorThe foreground color for normal actions.naughty/list/actions.lua:101
notification_action_fg_selectedcolorThe foreground color for selected actions.naughty/list/actions.lua:106
notification_action_icon_onlybooleanWhether or not the action label should be shown.naughty/list/actions.lua:47
notification_action_icon_size_normalnumberThe action icon size.naughty/list/actions.lua:83
notification_action_icon_size_selectednumberThe selected action icon size.naughty/list/actions.lua:87
notification_action_label_onlybooleanWhether or not the action icon should be shown.naughty/list/actions.lua:51
notification_action_shape_border_color_normalcolorThe shape border color for normal actions.naughty/list/actions.lua:65
notification_action_shape_border_color_selectedcolorThe shape border color for selected actions.naughty/list/actions.lua:70
notification_action_shape_border_width_normalnumberThe shape border width for normal actions.naughty/list/actions.lua:75
notification_action_shape_border_width_selectednumberThe shape border width for selected actions.naughty/list/actions.lua:79
notification_action_shape_normalgears.shapeThe shape used for a normal action.naughty/list/actions.lua:55
notification_action_shape_selectedgears.shapeThe shape used for a selected action.naughty/list/actions.lua:60
notification_action_underline_normalbooleanWhether or not to underline the action name.naughty/list/actions.lua:39
notification_action_underline_selectedbooleanWhether or not to underline the selected action name.naughty/list/actions.lua:43
notification_bgcolorNotifications background color.naughty/notification.lua:37
notification_bg_normalcolorThe background color for normal notifications.naughty/list/notifications.lua:61
notification_bg_selectedcolorThe background color for selected notifications.naughty/list/notifications.lua:66
notification_bgimage_normalstring|gears.surfaceThe background image for normal notifications.naughty/list/notifications.lua:81
notification_bgimage_selectedstring|gears.surfaceThe background image for selected notifications.naughty/list/notifications.lua:86
notification_border_colorcolorNotifications border color.naughty/notification.lua:49
notification_border_widthintNotifications border width.naughty/notification.lua:45
notification_fgcolorNotifications foreground color.naughty/notification.lua:41
notification_fg_normalcolorThe foreground color for normal notifications.naughty/list/notifications.lua:71
notification_fg_selectedcolorThe foreground color for selected notifications.naughty/list/notifications.lua:76
notification_fontstring|lgi.Pango.FontDescriptionNotifications font.naughty/notification.lua:33
notification_heightintNotifications height.naughty/notification.lua:70
notification_icon_resize_strategynumberThe default way to resize the icon.naughty/widget/icon.lua:28
notification_icon_sizenumberThe default notification icon size.naughty/widget/icon.lua:83
notification_icon_size_normalnumberThe notification icon size.naughty/list/notifications.lua:53
notification_icon_size_selectednumberThe selected notification icon size.naughty/list/notifications.lua:57
notification_marginintThe margins inside of the notification widget (or popup).naughty/notification.lua:62
notification_max_widthnumberThe maximum notification width.naughty/layout/box.lua:114
notification_opacityintNotifications opacity.naughty/notification.lua:58
notification_positionstringThe maximum notification position. Valid values are: * top_left * top_middle * top_right * bottom_left * bottom_middle * bottom_rightnaughty/layout/box.lua:118
notification_shapegears.shapeNotifications shape.naughty/notification.lua:53
notification_shape_border_color_normalcolorThe shape border color for normal notifications.naughty/list/notifications.lua:35
notification_shape_border_color_selectedcolorThe shape border color for selected notifications.naughty/list/notifications.lua:40
notification_shape_border_width_normalnumberThe shape border width for normal notifications.naughty/list/notifications.lua:45
notification_shape_border_width_selectednumberThe shape border width for selected notifications.naughty/list/notifications.lua:49
notification_shape_normalgears.shapeThe shape used for a normal notification.naughty/list/notifications.lua:25
notification_shape_selectedgears.shapeThe shape used for a selected notification.naughty/list/notifications.lua:30
notification_spacingnumberThe spacing between the notifications.naughty/notification.lua:74
notification_widthintNotifications width.naughty/notification.lua:66

8 entries.

VariableTypeDescriptionSource
launcher_width somewm-onlynumberThe launcher's width, ahead of menubar.geometry.width. Without either, the launcher spans the workarea.menubar/init.lua:77
menubar_bg_focuscolorMenubar selected item background color.menubar/init.lua:69
menubar_bg_normalcolorMenubar normal background color.menubar/init.lua:53
menubar_border_colorcolorMenubar border color.menubar/init.lua:61
menubar_border_widthnumberMenubar border width.menubar/init.lua:57
menubar_fg_focuscolorMenubar selected item text color.menubar/init.lua:65
menubar_fg_normalcolorMenubar normal text color.menubar/init.lua:49
menubar_fontfontMenubar font.menubar/init.lua:73

somewm​

19 entries.

VariableTypeDescriptionSource
animation_appear somewm-onlystring|tableThe entrance every client maps with: grow, scale, scale_top, scale_bottom, scale_left, scale_right, slide_left, slide_right, slide_up, slide_down or fade. A list combines effects simultaneously, with at most one slide, one size effect (grow or a scale word) and fade.somewm/animation.lua:52
animation_appear_duration somewm-onlynumberA client mapping, in seconds. Needs an entrance from animation_appear or c.animation.appear.somewm/animation.lua:33
animation_disappear somewm-onlystring|tableThe exit every client closes with, same words as animation_appear.somewm/animation.lua:59
animation_disappear_duration somewm-onlynumberA client closing, in seconds. Needs an entrance from animation_disappear or c.animation.disappear.somewm/animation.lua:38
animation_duration somewm-onlynumberThe duration for every trigger that has none of its own, in seconds. Applies to layout too. With no duration configured, nothing animates. 0 snaps.somewm/animation.lua:15
animation_floating_duration somewm-onlynumberA client toggling floating, in seconds.somewm/animation.lua:29
animation_focus_duration somewm-onlynumberThe border colour easing on a focus change, in seconds.somewm/animation.lua:48
animation_layout_duration somewm-onlynumberTiled clients moving between slots, in seconds. 0 snaps. Requiring the deprecated somewm.layout_animation sets 0.15.somewm/animation.lua:20
animation_maximize_duration somewm-onlynumberA client maximizing or going fullscreen, in seconds.somewm/animation.lua:25
animation_tag somewm-onlystring|tableThe entrance and exit on a tag switch, same words as animation_appear. Defaults to grow. c.animation.tag can override it.somewm/animation.lua:63
animation_tag_duration somewm-onlynumberA tag switch, in seconds. Clients grow in and out unless c.animation.tag or animation_tag names another entrance.somewm/animation.lua:43
inspector_bg somewm-onlycolorThe panel body and its odd rows.somewm/inspector.lua:29
inspector_bg_alt somewm-onlycolorThe header, the even rows, and the info and warnings panes.somewm/inspector.lua:33
inspector_bg_selected somewm-onlycolorThe selected tree row.somewm/inspector.lua:45
inspector_border somewm-onlycolorDividers, row borders and dim text (ids, the Offscreen tag).somewm/inspector.lua:37
inspector_fg somewm-onlycolorText and swatch borders.somewm/inspector.lua:41
inspector_font somewm-onlystringThe panel font. A size, absolute ("Monospace 14px") or in points ("Monospace 10"), sizes the panel's text. Without one Clay's 16px stands. Rows are 30px, so sizes past about 20px overflow them.somewm/inspector.lua:58
inspector_highlight somewm-onlycolorThe overlay drawn over the hovered element out on the desktop. Its alpha shows the element through.somewm/inspector.lua:49
inspector_width somewm-onlynumberThe panel width in logical pixels.somewm/inspector.lua:54

root​

12 entries.

VariableTypeDescriptionSource
awesome_iconstring|gears.surfaceThe Awesome icon path.beautiful/init.lua:142
bg_focuscolorThe default focused element background color.beautiful/init.lua:105
bg_minimizecolorThe default minimized element background color.beautiful/init.lua:113
bg_normalcolorThe default background color. The background color can be transparent. If there is a compositing manager such as compton, then it will be real transparency and may include blur (provided by the compositor). When there is no compositor, it will take a picture of the wallpaper and blend it.beautiful/init.lua:94
bg_urgentcolorThe default urgent element background color.beautiful/init.lua:109
fg_focuscolorThe default focused element foreground (text) color.beautiful/init.lua:121
fg_minimizecolorThe default minimized element foreground (text) color.beautiful/init.lua:129
fg_normalcolorThe default focused element foreground (text) color.beautiful/init.lua:117
fg_urgentcolorThe default urgent element foreground (text) color.beautiful/init.lua:125
fontstringThe default font.beautiful/init.lua:90
icon_themestringThe icon theme name. It has to be a directory in /usr/share/icons or an XDG icon folder.beautiful/init.lua:137
wallpaperstring|gears.surfaceThe wallpaper path.beautiful/init.lua:133

Undocumented (Used in Code)​

88 theme variables are read in source but lack an @beautiful annotation. Their types and accepted values are not annotated.

VariableUsed at
border_colorawful/permissions/init.lua:746
border_color_activeawful/permissions/init.lua:615, naughty/notification.lua:892
border_color_floatingawful/permissions/init.lua:619
border_color_floating_activeawful/permissions/init.lua:620
border_color_floating_newawful/permissions/init.lua:622
border_color_floating_normalawful/permissions/init.lua:621
border_color_floating_urgentawful/permissions/init.lua:623
border_color_fullscreenawful/permissions/init.lua:629
border_color_fullscreen_activeawful/permissions/init.lua:630
border_color_fullscreen_newawful/permissions/init.lua:632
border_color_fullscreen_normalawful/permissions/init.lua:631
border_color_fullscreen_urgentawful/permissions/init.lua:633
border_color_markedawful/permissions/init.lua:614, awful/permissions/init.lua:719, awful/permissions/init.lua:720
border_color_maximizedawful/permissions/init.lua:624
border_color_maximized_activeawful/permissions/init.lua:625
border_color_maximized_newawful/permissions/init.lua:627
border_color_maximized_normalawful/permissions/init.lua:626
border_color_maximized_urgentawful/permissions/init.lua:628
border_color_newawful/permissions/init.lua:617
border_color_normalawful/permissions/init.lua:616, awful/tooltip.lua:495, awful/tooltip.lua:711 (+1 more)
border_color_urgentawful/permissions/init.lua:618
border_focusawful/permissions/init.lua:741, awful/permissions/init.lua:742
border_markedawful/permissions/init.lua:722, awful/permissions/init.lua:723
border_normalawful/permissions/init.lua:739, awful/permissions/init.lua:740
border_widthawful/hotkeys_popup/widget.lua:357, awful/hotkeys_popup/widget.lua:407, awful/permissions/init.lua:710 (+1 more)
border_width_activeawful/permissions/init.lua:634
border_width_floatingawful/permissions/init.lua:638
border_width_floating_activeawful/permissions/init.lua:639
border_width_floating_newawful/permissions/init.lua:641
border_width_floating_normalawful/permissions/init.lua:640
border_width_floating_urgentawful/permissions/init.lua:642
border_width_fullscreenawful/permissions/init.lua:648
border_width_fullscreen_activeawful/permissions/init.lua:649
border_width_fullscreen_newawful/permissions/init.lua:651
border_width_fullscreen_normalawful/permissions/init.lua:650
border_width_fullscreen_urgentawful/permissions/init.lua:652
border_width_maximizedawful/permissions/init.lua:643
border_width_maximized_activeawful/permissions/init.lua:644
border_width_maximized_newawful/permissions/init.lua:646
border_width_maximized_normalawful/permissions/init.lua:645
border_width_maximized_urgentawful/permissions/init.lua:647
border_width_newawful/permissions/init.lua:636
border_width_normalawful/permissions/init.lua:635
border_width_urgentawful/permissions/init.lua:637
calendar_awful/widget/calendar_popup.lua:45
calendar_flex_heightwibox/widget/calendar.lua:422
clock_bgsomewmrc.lua:295
hotkeys_opacityawful/hotkeys_popup/widget.lua:420
load_fontbeautiful/init.lua:183
lockscreen_bg_colorlockscreen.lua:292
lockscreen_border_colorlockscreen.lua:292
lockscreen_clock_formatlockscreen.lua:292
lockscreen_date_formatlockscreen.lua:292
lockscreen_error_colorlockscreen.lua:292
lockscreen_fg_colorlockscreen.lua:292
lockscreen_fontlockscreen.lua:300, lockscreen.lua:292
lockscreen_font_largelockscreen.lua:292
lockscreen_input_bglockscreen.lua:292
lockscreen_wallpaperlockscreen.lua:309
lockscreen_wallpaper_overlaylockscreen.lua:292
notification_naughty/notification.lua:852
notification_actionnaughty/list/actions.lua:209, naughty/list/notifications.lua:190
notification_paddingnaughty/layout/box.lua:82
opacity_activeawful/permissions/init.lua:668
opacity_floatingawful/permissions/init.lua:653
opacity_floating_activeawful/permissions/init.lua:654
opacity_floating_newawful/permissions/init.lua:656
opacity_floating_normalawful/permissions/init.lua:655
opacity_floating_urgentawful/permissions/init.lua:657
opacity_fullscreenawful/permissions/init.lua:663
opacity_fullscreen_activeawful/permissions/init.lua:664
opacity_fullscreen_newawful/permissions/init.lua:666
opacity_fullscreen_normalawful/permissions/init.lua:665
opacity_fullscreen_urgentawful/permissions/init.lua:667
opacity_maximizedawful/permissions/init.lua:658
opacity_maximized_activeawful/permissions/init.lua:659
opacity_maximized_newawful/permissions/init.lua:661
opacity_maximized_normalawful/permissions/init.lua:660
opacity_maximized_urgentawful/permissions/init.lua:662
opacity_newawful/permissions/init.lua:670
opacity_normalawful/permissions/init.lua:669
opacity_urgentawful/permissions/init.lua:671
progressbar_clipwibox/widget/progressbar.lua:359
theme_pathbeautiful/init.lua:147
titlebar_fontawful/titlebar.lua:785
wallpaper_colorssomewmrc.lua:224
wallpaper_logo_colorsomewmrc.lua:91, somewmrc.lua:227
xresources_dpigears/xresources.lua:171

See Also​