mangowm/mango
0
0 Fork 0
mirror of https://github.com/mangowm/mango.git synced 2026-08-19 05:19:24 -07:00
Code Issues Packages Projects Releases Wiki Activity
Page: layouts
Pages
Home animations basics effects faq input installation ipc keys layouts miscellaneous monitors mouse gestures nix options overview quick start rules scratchpad screenshot status bar theming xdg portals
Clone
12
layouts
github-actions[bot] edited this page 2026-08-13 12:43:56 +00:00
Unescape Escape
Table of Contents
This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Supported Layouts

mangowm supports a variety of layouts that can be assigned per tag.

  • tile
  • scroller
  • monocle
  • grid
  • deck
  • center_tile
  • vertical_tile
  • right_tile
  • vertical_scroller
  • vertical_grid
  • vertical_deck
  • dwindle
  • fair
  • vertical_fair

Scroller Layout

The Scroller layout positions windows in a scrollable strip, similar to PaperWM.

Configuration

Setting Default Description
scroller_structs 20 Width reserved on sides when window ratio is 1.
scroller_default_proportion 0.9 Default width proportion for new windows.
scroller_focus_center 0 Always center the focused window (1 = enable).
scroller_prefer_center 0 Center focused window only if it was outside the view.
scroller_prefer_overspread 1 Allow windows to overspread when there's extra space.
edge_scroller_pointer_focus 1 Focus windows even if partially off-screen.
edge_scroller_focus_allow_speed 0.0 Allow pointer focus to happen if the pointer moves at a speed greater than this value.
scroller_proportion_preset 0.5,0.8,1.0 Presets for cycling window widths.
scroller_ignore_proportion_single 1 Ignore proportion adjustments for single windows.
scroller_default_proportion_single 1.0 Default proportion for single windows in scroller. Requires scroller_ignore_proportion_single=0 to take effect.

Warning: scroller_prefer_overspread, scroller_focus_center, and scroller_prefer_center interact with each other. Their priority order is:

scroller_prefer_overspread > scroller_focus_center > scroller_prefer_center

To ensure a lower-priority setting takes effect, you must set all higher-priority options to 0.

# Example scroller configuration
scroller_structs=20
scroller_default_proportion=0.9
scroller_focus_center=0
scroller_prefer_center=0
scroller_prefer_overspread=1
edge_scroller_pointer_focus=1
edge_scroller_focus_allow_speed=0.0
scroller_default_proportion_single=1.0
scroller_proportion_preset=0.5,0.8,1.0

Master-Stack Layouts

These settings apply to layouts like tile and center_tile.

Setting Default Description
new_is_master 1 New windows become the master window.
default_mfact 0.55 The split ratio between master and stack areas.
default_nmaster 1 Number of allowed master windows.
tag_num 9 Number of tags/workspaces (1–31). On config reload, clients on tags beyond this count are moved to the last tag.
tag_gather 0 When 1, occupied tags are compacted to consecutive tags starting at 1, eliminating gaps. For example, with windows on tags 1, 3 and 9, they move to 1, 2 and 3, and the current view follows.
smartgaps 0 Disable gaps when only one window is present.
center_master_overspread 0 (Center Tile) Master spreads across screen if no stack exists.
center_when_single_stack 1 (Center Tile) Center master when only one stack window exists. 
# Example master-stack configuration
new_is_master=1
smartgaps=0
default_mfact=0.55
default_nmaster=1
tag_num=9
tag_gather=0

Dwindle Layout

The Dwindle layout arranges windows as a binary tree of recursive splits. Each new window splits the focused window's container, producing a spiral-like tiling.

Configuration

Setting Default Description
dwindle_split_ratio 0.5 Ratio used for new splits (0.05–0.95).
dwindle_smart_split 0 Pick the split axis from the cursor's position inside the focused window. The new window appears on the cursor's side.
dwindle_hsplit 1 Side-by-side splits: where the new window goes. 0 = follow cursor, 1 = right, 2 = left.
dwindle_vsplit 1 Top/bottom splits: where the new window goes. 0 = follow cursor, 1 = below, 2 = above.
dwindle_preserve_split 0 Keep the sibling's split orientation when a window is closed.
dwindle_smart_resize 0 When dragging to resize, move the split toward the cursor regardless of which side was grabbed.
dwindle_drop_simple_split 1 Drag-to-tile drop preview. 1 = 2-zone preview matching dwindle_split_ratio, 0 = 4-quadrant preview.
dwindle_manual_split 0 Manually split windows mode. 
# Example dwindle configuration
dwindle_split_ratio=0.5
dwindle_smart_split=0
dwindle_hsplit=0
dwindle_vsplit=0
dwindle_preserve_split=0
dwindle_smart_resize=0
dwindle_drop_simple_split=1

Switching Layouts

Setting Default Description
circle_layout - A comma-separated list of layouts switch_layout cycles through,the value sample:tile,scroller.

You can switch layouts dynamically or set a default for specific tags using Tag Rules.

Keybinding Examples:

# Cycle through layouts
circle_layout=grid,scroller,tile
bind=SUPER,n,switch_layout

# Set specific layout
bind=SUPER,t,setlayout,tile
bind=SUPER,s,setlayout,scroller

General

Bindings

Configuration

Visuals

Window Management