Skip to content

Multi-Monitor Workspace Placement

plugin:hyprexpo:workspace_method can be global, per-monitor, or a mix of per-monitor entries with a global fallback.

Formats

text
center <workspace>
first <workspace>
MONITOR center <workspace>
MONITOR first <workspace>

Separate multiple entries with commas:

ini
plugin {
    hyprexpo {
        workspace_method = DP-1 first 1, HDMI-1 center 5, eDP-1 first 10
    }
}

Mixed monitor-specific entries and fallback:

ini
plugin {
    hyprexpo {
        workspace_method = DP-1 first 1, center current
    }
}

Active workspace beyond the grid

first <workspace> anchors the grid to a fixed workspace and counts upward, so the configured columns normally bound how many workspaces are visible. When the currently active workspace sits past the last tile (for example first 1 with columns = 3 shows workspaces 1–9, but the active workspace is 10), the overview temporarily grows the grid so the active workspace stays visible and the open/close animation focuses on it instead of the anchor tile. The grid only grows — never below the configured columns — and is capped at the maximum of 7 columns. This applies to plain sequential grids (not skip_empty or max_workspace, which keep their explicit bounds).

Troubleshooting Monitor Names

If a per-monitor entry does not apply, check the monitor name reported by Hyprland and use that exact name in the comma-separated list.

Invalid values should fall back safely instead of crashing the compositor.

HyprExpo is a maintained Hyprland plugin fork.