Skip to main content

​
Colors

Mango uses hexadecimal RGBA color format: 0xRRGGBBAA

​
Border Colors

​
bordercolor
color
default:"0x444444ff"
Default border color for unfocused windows
bordercolor=0x444444ff
​
focuscolor
color
default:"0xc9b890ff"
Border color for the focused window
focuscolor=0xc9b890ff
​
urgentcolor
color
default:"0xad401fff"
Border color for windows requesting attention
urgentcolor=0xad401fff

​
Special State Colors

​
maximizescreencolor
color
default:"0x89aa61ff"
Border color for maximized windows
maximizescreencolor=0x89aa61ff
​
scratchpadcolor
color
default:"0x516c93ff"
Border color for scratchpad windows
scratchpadcolor=0x516c93ff
​
globalcolor
color
default:"0xb153a7ff"
Border color for global windows (visible on all tags)
globalcolor=0xb153a7ff
​
overlaycolor
color
default:"0x14a57cff"
Border color for overlay windows
overlaycolor=0x14a57cff

​
Background Color

​
rootcolor
color
default:"0x201b14ff"
Background color for the desktop
rootcolor=0x201b14ff

​
Borders

​
borderpx
integer
default:"4"
Border width in pixels
borderpx=4
​
no_border_when_single
boolean
default:"0"
Hide borders when only one window is visible
  • 1 - Hide border when single window
  • 0 - Always show borders
no_border_when_single=0

​
Gaps

Mango supports separate inner and outer gaps:

​
Inner Gaps

Space between windows:
​
gappih
integer
default:"5"
Inner horizontal gap in pixels
gappih=5
​
gappiv
integer
default:"5"
Inner vertical gap in pixels
gappiv=5

​
Outer Gaps

Space between windows and screen edges:
​
gappoh
integer
default:"10"
Outer horizontal gap in pixels
gappoh=10
​
gappov
integer
default:"10"
Outer vertical gap in pixels
gappov=10

​
Smart Gaps

​
smartgaps
boolean
default:"0"
Hide gaps when only one window is visible
  • 1 - Enable smart gaps
  • 0 - Always show gaps
smartgaps=0

​
Runtime Gap Control

You can adjust gaps dynamically with keybindings: 
# Increase all gaps by 1 pixel
bind=ALT+SHIFT,X,incgaps,1

# Decrease all gaps by 1 pixel
bind=ALT+SHIFT,Z,incgaps,-1

# Toggle gaps on/off
bind=ALT+SHIFT,R,togglegaps

​
Window Opacity

​
focused_opacity
float
default:"1.0"
Opacity for focused windows (0.0 - 1.0)
focused_opacity=1.0
​
unfocused_opacity
float
default:"1.0"
Opacity for unfocused windows (0.0 - 1.0)
unfocused_opacity=1.0

​
Overview Settings

Appearance settings for overview mode:
​
overviewgappi
integer
default:"5"
Inner gap between windows in overview mode
overviewgappi=5
​
overviewgappo
integer
default:"30"
Outer gap from screen edges in overview mode
overviewgappo=30
​
ov_tab_mode
boolean
default:"0"
Enable tab mode in overview
ov_tab_mode=0
​
hotarea_size
integer
default:"10"
Size of hot area for triggering overview in pixels
hotarea_size=10
​
enable_hotarea
boolean
default:"1"
Enable hot corner/area for overview
enable_hotarea=1

​
Scratchpad Appearance

​
scratchpad_width_ratio
float
default:"0.8"
Scratchpad width as ratio of screen width (0.0 - 1.0)
scratchpad_width_ratio=0.8
​
scratchpad_height_ratio
float
default:"0.9"
Scratchpad height as ratio of screen height (0.0 - 1.0)
scratchpad_height_ratio=0.9

​
Cursor Settings

​
cursor_size
integer
default:"24"
Cursor size in pixels
cursor_size=24

​
Example Configuration

Here’s a complete appearance configuration example: 
# Colors
rootcolor=0x201b14ff
bordercolor=0x444444ff
focuscolor=0xc9b890ff
maximizescreencolor=0x89aa61ff
urgentcolor=0xad401fff
scratchpadcolor=0x516c93ff
globalcolor=0xb153a7ff
overlaycolor=0x14a57cff

# Borders
borderpx=4
no_border_when_single=0

# Gaps
gappih=5
gappiv=5
gappoh=10
gappov=10
smartgaps=0

# Opacity
focused_opacity=1.0
unfocused_opacity=1.0

# Overview
hotarea_size=10
enable_hotarea=1
ov_tab_mode=0
overviewgappi=5
overviewgappo=30

# Scratchpad
scratchpad_width_ratio=0.8
scratchpad_height_ratio=0.9

# Cursor
cursor_size=24

​
Color Examples

​
Material Design Colors

focuscolor=0x2196F3ff     # Blue
urgentcolor=0xF44336ff    # Red
scratchpadcolor=0x4CAF50ff # Green

​
Pastel Theme

focuscolor=0xFFB6C1ff     # Light pink
bordercolor=0xE6E6FAff    # Lavender
rootcolor=0xFFF8DCff      # Cornsilk

​
Dark Theme

rootcolor=0x1a1a1aff      # Very dark gray
bordercolor=0x333333ff    # Dark gray
focuscolor=0x666666ff     # Medium gray

Build docs developers (and LLMs) love

Get started for freeTalk to us