theming

Dimensions

Control the sizing of window borders and gaps.

Setting	Default	Description
border_px	4	Border width in pixels.
gap_inner_horizontal	5	Horizontal inner gap (between windows).
gap_inner_vertical	5	Vertical inner gap.
gap_outer_horizontal	10	Horizontal outer gap (between windows and screen edges).
gap_outer_vertical	10	Vertical outer gap.

Colors

Colors are defined in 0xRRGGBBAA hex format.

# Background color of the root window
root_color=0x323232ff

# Inactive window border
border_color=0x444444ff

# Drop shadow when dragging windows
drop_color=0x8FBA7C55

# Split window border color in manual dwindle layout
split_color=0xEB441EFF

# Active window border
focus_color=0xc66b25ff

# Urgent window border (alerts)
urgent_color=0xad401fff

State-Specific Colors

You can also color-code windows based on their state:

State	Config Key	Default Color
Maximized	maximized_screen_color	0x89aa61ff
Scratchpad	scratchpad_color	0x516c93ff
Global	global_color	0xb153a7ff
Overlay	overlay_color	0x14a57cff

Tip: For scratchpad window sizing, see Scratchpad configuration.

Overview Jump Mode

Setting	Default	Description
jump_label_decorate_fg_color	0xc4939dff	text color.
jump_label_decorate_bg_color	0x323232ff	background color.
jump_label_decorate_focus_fg_color	0xeda6b4ff	text color for focus.
jump_label_decorate_focus_bg_color	0x4e453cff	background color for focus.
jump_label_decorate_border_color	0x8BAA9Bff	border color.
jump_label_decorate_border_width	4	border width.
jump_label_decorate_corner_radius	5	corner radius.
jump_label_decorate_padding_x	10	horizontal padding.
jump_label_decorate_padding_y	10	vertical padding.
jump_label_decorate_font_desc	monospace Bold 16	font set.

Group Bar

Setting	Default	Description
always_show_group_bar	0	Show the group bar on every window.
group_bar_height	33	Group bar height.
group_bar_close_button_enable	0	Show the close button. Independent of always_show_group_bar.
group_bar_button_size	16	Close button size in px.
group_bar_button_margin	4	Close button inset from the right edge in px.
group_bar_button_color	0xad401fff	Close button colour.
group_bar_decorate_fg_color	0xc0caf5ff	text color.
group_bar_decorate_bg_color	0x1d2021ff	background color.
group_bar_decorate_focus_fg_color	0x9ece6aff	text color for focus.
group_bar_decorate_focus_bg_color	0x3c3836ff	background color for focus.
group_bar_decorate_border_color	0x3b4261ff	border color.
group_bar_decorate_border_width	4	border width.
group_bar_decorate_corner_radius	5	corner radius.
group_bar_decorate_padding_x	0	horizontal padding.
group_bar_decorate_padding_y	0	vertical padding.
group_bar_decorate_font_desc	monospace Bold 13	font set.

Auto Tab Bar

Setting	Default	Description
tab_bar_height	33	Height of the auto tab bar.
tab_bar_decorate_fg_color	0xc0caf5ff	text color.
tab_bar_decorate_bg_color	0x1d2021ff	background color.
tab_bar_decorate_focus_fg_color	0x7aa2f7ff	text color for focus.
tab_bar_decorate_focus_bg_color	0x3c3836ff	background color for focus.
tab_bar_decorate_border_color	0x3b4261ff	border color.
tab_bar_decorate_border_width	4	border width.
tab_bar_decorate_corner_radius	5	corner radius.
tab_bar_decorate_padding_x	0	horizontal padding.
tab_bar_decorate_padding_y	0	vertical padding.
tab_bar_decorate_font_desc	monospace Bold 13	font set.

Title Message Bar

Shown below the focused window in overcircle mode and below the switcher panel, using the highlighted window's title and app id on two lines. The width follows the focused overview card or the switcher panel.

Setting	Default	Description
title_message_bar_height	52	Title message bar height. Set to 0 to disable it.
title_message_bar_gap	20	Gap between the bar and the focused overview card or switcher panel.
title_message_bar_decorate_fg_color	0xc0caf5ff	Text color.
title_message_bar_decorate_bg_color	0x1d2021ff	Background color.
title_message_bar_decorate_focus_fg_color	0x9ece6aff	Text color while focused.
title_message_bar_decorate_focus_bg_color	0x3c3836ff	Background color while focused.
title_message_bar_decorate_border_color	0x3b4261ff	Border color.
title_message_bar_decorate_border_width	0	Border width.
title_message_bar_decorate_corner_radius	15	Corner radius.
title_message_bar_decorate_padding_x	0	Horizontal padding.
title_message_bar_decorate_padding_y	0	Vertical padding.
title_message_bar_decorate_font_desc	monospace Bold 13	Font description.

Borders

Control the appearance of window borders.

Cursor Theme

Set the size and theme of your mouse cursor.

cursor_size=24
cursor_theme=Adwaita