mangowmOverview
Configure overview, jump mode, overcircle, and the window switcher.
Mango has four related ways to inspect or switch windows: the standard overview, jump mode, overcircle, and the switcher. They share some appearance settings, but each mode has its own entry command and interaction model.
| Mode | Layout | Primary command |
|---|---|---|
| Overview | Packed cards in the normal overview grid | toggleoverview |
| Jump mode | Overview grid with one-key jump hints | togglejump |
| Overcircle | Focused card in the center with other windows on both sides | overcircle |
| Switcher | Centered thumbnail panel | switcher |
The keybindings below are examples; replace the shortcuts with ones that are free in your configuration. For the complete dispatcher reference, see Keybindings.
Overview
The standard overview packs every window on the current monitor into a grid.
By default it includes windows from every tag. Pass 1 to
toggleoverview to include only windows on the current tagset.
Keybindings
# Toggle the overview for all tags
bind=SUPER+ALT,o,toggleoverview,
# Toggle the overview for the current tagset only
bind=SUPER+ALT+SHIFT,o,toggleoverview,1
# Enter or leave without toggling
bind=SUPER+ALT,Return,enteroverview,
bind=SUPER+ALT+Escape,leaveoverview,| Command | Parameter | Description |
|---|---|---|
toggleoverview | [1] | Toggle the standard overview. Use 1 to restrict it to the current tagset. |
enteroverview | - | Enter the standard overview. |
leaveoverview | - | Leave the overview. |
The default configuration also provides four-finger swipe gestures for entering and leaving the overview:
gesturebind=none,up,4,enteroverview
gesturebind=none,down,4,leaveoverviewConfiguration
| Setting | Type | Default | Description |
|---|---|---|---|
overview_gap_inner | integer | 5 | Gap between cards. Range: 0–1000. |
overview_gap_outer | integer | 30 | Gap between the card grid and the monitor edges. Range: 0–1000. |
enable_hotarea | integer | 0 | Enter the standard overview when the pointer enters the configured corner (0: disabled, 1: enabled). |
hotarea_size | integer | 10 | Width and height of the hot-area trigger in pixels. Range: 1–1000. |
hotarea_corner | integer | 2 | Trigger corner: 0 top-left, 1 top-right, 2 bottom-left, 3 bottom-right. |
hotarea_disable_on_fullscreen | integer | 1 | Do not trigger the hot area while a fullscreen window is focused (0: disabled, 1: enabled). |
overview_gap_inner=5
overview_gap_outer=30
enable_hotarea=1
hotarea_size=10
hotarea_corner=2
hotarea_disable_on_fullscreen=1Jump Mode
Jump mode displays the standard overview grid and places a character hint on
each visible window. Press a hint to focus that window and leave the overview.
Press Escape to leave without selecting a window.
The shipped default binding is ALT+Tab.
Keybindings
# Toggle the overview and its jump hints
bind=ALT,Tab,togglejump,| Interaction | Description |
|---|---|
| Hint key | Focus the window marked with that hint and close the overview. |
Escape | Close jump mode without changing focus. |
| Command | Parameter | Description |
|---|---|---|
togglejump | - | Enter the overview in jump mode; if an overview is already open, close it. |
Configuration
| Setting | Type | Default | Description |
|---|---|---|---|
jump_labels | string | HJKLASDFGQWERTYUIOPZXCVBNM | Ordered characters assigned as window hints. Hints are assigned only to visible windows, so the string length limits how many windows receive one. Label matching uses the configured keyboard layouts and falls back to us. |
# Assign hints in this order
jump_labels=HJKLASDFGQWERTYUIOPZXCVBNMHint colors, border, padding, corner radius, and font use the
jump_label_decorate_* settings. See
Overview Jump Mode for the complete
list.
Overcircle
Overcircle keeps the focused window in a centered column and distributes the remaining windows across columns on its left and right. Repeated use of the same binding cycles focus around the current monitor.
next and prev show windows from all tags. current_next and
current_prev restrict the overview to the current tagset. Releasing a modifier
key exits overcircle.
Keybindings
# Cycle forward/backward through all tags on the current monitor
bind=SUPER+ALT,j,overcircle,next
bind=SUPER+ALT+SHIFT,j,overcircle,prev
# Cycle forward/backward through the current tagset only
bind=SUPER+CTRL,j,overcircle,current_next
bind=SUPER+CTRL+SHIFT,j,overcircle,current_prev| Command | Parameter | Description |
|---|---|---|
overcircle | next | Enter or cycle forward through every window on the current monitor. |
overcircle | prev | Enter or cycle backward through every window on the current monitor. |
overcircle | current_next | Enter or cycle forward through the current tagset only. |
overcircle | current_prev | Enter or cycle backward through the current tagset only. |
Configuration
Overcircle uses the same inner and outer overview gaps as the standard overview, plus settings for the centered column and title message bar.
| Setting | Type | Default | Description |
|---|---|---|---|
overview_gap_inner | integer | 5 | Gap between cards in the center and side columns. Range: 0–1000. |
overview_gap_outer | integer | 30 | Gap around the overcircle layout. Range: 0–1000. |
overcircle_center_ratio | float | 0.5 | Width of the centered focused window as a fraction of the usable screen width. Range: 0.1–0.9. |
title_message_bar_height | integer | 52 | Height of the focused window's title message bar. Set to 0 to disable it. |
title_message_bar_gap | integer | 20 | Gap between the focused card and its title message bar. |
overview_gap_inner=5
overview_gap_outer=30
overcircle_center_ratio=0.5
title_message_bar_height=52
title_message_bar_gap=20The title message bar shows the window title on the first line and its app id on the second. Its decoration is shared with the switcher; see Title Message Bar.
Switcher
The switcher opens a centered panel of live window thumbnails. Use it to cycle through the current tag, all tags on the current monitor, or all windows on all monitors. Releasing any modifier key commits the highlighted window.
The switcher cannot open while any monitor is showing an overview, including jump mode and overcircle.
Keybindings
# Current tag
bind=ALT,grave,switcher,next
bind=ALT+SHIFT,grave,switcher,prev
# All tags on the current monitor
bind=SUPER+ALT,grave,switcher,all_tag_next
bind=SUPER+ALT+SHIFT,grave,switcher,all_tag_prev
# All monitors and tags
bind=SUPER+CTRL+ALT,grave,switcher,all_next
bind=SUPER+CTRL+ALT+SHIFT,grave,switcher,all_prev| Command | Parameter | Description |
|---|---|---|
switcher | next / prev | Open or cycle through windows on the current tag. |
switcher | all_tag_next / all_tag_prev | Open or cycle through every window on the current monitor. |
switcher | all_next / all_prev | Open or cycle through every window on every monitor. |
Configuration
The switcher has no dedicated size or layout options. Its focused thumbnail
frame uses focus_color, other thumbnail frames use border_color, and it
shares the title message bar with overcircle.
| Setting | Type | Default | Description |
|---|---|---|---|
title_message_bar_height | integer | 52 | Height of the highlighted window's title message bar. Set to 0 to disable it. |
title_message_bar_gap | integer | 20 | Gap between the switcher panel and its title message bar. |
focus_color | color | 0xc66b25ff | Frame color of the highlighted thumbnail. |
border_color | color | 0x444444ff | Frame color of the other thumbnails. |
title_message_bar_height=52
title_message_bar_gap=20
focus_color=0xc66b25ff
border_color=0x444444ffMouse Interaction
The overview-based modes and the switcher accept direct pointer input:
| Mode | Left click | Right click |
|---|---|---|
| Overview, jump mode, overcircle | Focus the clicked window and leave the overview. | Close the clicked window. |
| Switcher | Commit the clicked thumbnail. | Close the clicked window. |
| Switcher panel background | Close the switcher. | Close the switcher. |
Last updated on