mangowm

Overview

Configure the overview mode for window navigation.

Overview Settings

SettingTypeDefaultDescription
hotarea_sizeinteger10Hot area size in pixels.
enable_hotareainteger0Enable hot areas (0: disable, 1: enable).
hotarea_disable_on_fullscreeninteger1Disable hot areas while a fullscreen window is focused (0: disable, 1: enable).
hotarea_cornerinteger2Hot area corner (0: top-left, 1: top-right, 2: bottom-left, 3: bottom-right).
overview_gap_innerinteger5Inner gap in overview mode.
overview_gap_outerinteger30Outer gap in overview mode.
overcircle_center_ratiofloat0.5Width ratio of the centered window in the overcircle layout (0.1–0.9).
title_message_bar_heightinteger52Height of the focused window's title bar below its card in overcircle mode. Set to 0 to disable it.
title_message_bar_gapinteger20Gap between the focused window's card and its title bar in overcircle mode.
jump_labelsstringHJKLASDFGQWERTYUIOPZXCVBNMCharacter sequence used for jump hints in overview mode.

Setting Descriptions

  • enable_hotarea — Toggles overview when the cursor enters the configured corner.
  • hotarea_disable_on_fullscreen — When enabled, the hot area does not trigger overview while a fullscreen window is focused.
  • hotarea_size — Size of the hot area trigger zone in pixels.
  • hotarea_corner — Corner that triggers the hot area (0: top-left, 1: top-right, 2: bottom-left, 3: bottom-right).
  • jump_labels — Defines the ordered characters used for jump hints when in overview jump mode. Each visible window is assigned a label in this order, and pressing the corresponding key jumps to that window. The number of labels limits how many windows can be assigned hints at once. A label is matched by keycode, resolved the same way as bind: against the layouts configured with xkb_rules_layout in their configured order, with the reference us layout as fallback. Jump mode therefore also works while a non-latin layout is active.

overcircle opens overview; while overview is open, each trigger cycles focus to the next window on the current monitor. Release a modifier key or run toggleoverview to close it.

By default overview temporarily views every tag on the monitor. Use overcircle with current_next/current_prev, or run toggleoverview,1, to keep the overview restricted to the current tagset's windows.

The title message bar shows the window title on the first line and its app id on the second. It also appears below the switcher panel for the highlighted window. Its width follows the switcher panel. See Theming for its decoration options.

Mouse Interaction in Overview

When in overview mode:

  • Left mouse button — Jump to (focus) a window.
  • Right mouse button — Close a window.

Last updated on

On this page