maomaowm/docs/visuals/theming.md
DreamMaoMao a515ad9b91
Some checks are pending
Sync website / sync-website (push) Waiting to run
Sync wiki / sync-wiki (push) Waiting to run
feat: add overview jump mode
2026-06-16 23:08:01 +08:00

2 KiB

title description
Theming Customize the visual appearance of borders, colors, and the cursor.

Dimensions

Control the sizing of window borders and gaps.

Setting Default Description
borderpx 4 Border width in pixels.
gappih 5 Horizontal inner gap (between windows).
gappiv 5 Vertical inner gap.
gappoh 10 Horizontal outer gap (between windows and screen edges).
gappov 10 Vertical outer gap.

Colors

Colors are defined in 0xRRGGBBAA hex format.

# Background color of the root window
rootcolor=0x323232ff

# Inactive window border
bordercolor=0x444444ff

# Drop shadow when dragging windows
dropcolor=0x8FBA7C55

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

# Active window border
focuscolor=0xc66b25ff

# Urgent window border (alerts)
urgentcolor=0xad401fff

State-Specific Colors

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

State Config Key Default Color
Maximized maximizescreencolor 0x89aa61ff
Scratchpad scratchpadcolor 0x516c93ff
Global globalcolor 0xb153a7ff
Overlay overlaycolor 0x14a57cff

Tip: For scratchpad window sizing, see Scratchpad configuration.

Overview Jump Mode

Setting Default Description
jump_hit_fg_color 0xc4939dff label text color.
jump_hit_bg_color 0x201b14ff label background color.
jump_hit_border_color 0x8BAA9Bff label border color.
jump_hit_border_width 4 label border width.
jump_hit_corner_radius 5 label corner radius.
jump_hit_padding_x 10 label horizontal padding.
jump_hit_padding_y 10 label vertical padding.
jump_hit_font_desc monospace Bold 24 label font set.

Cursor Theme

Set the size and theme of your mouse cursor.

cursor_size=24
cursor_theme=Adwaita