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

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

Separate multiple entries with commas:

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

Mixed monitor-specific entries and fallback:

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

Active workspace beyond the grid

With skip_empty = 0, max_workspace limits the workspace IDs shown without moving a first <workspace> or explicit center <workspace> anchor. Enumeration keeps Hyprland's monitor-aware ordering, including uncreated empty workspaces. For example, with workspaces 1–5 bound to one monitor and 6–9 to another, columns = 3, max_workspace = 9, and first 1 / first 6 show 1–5 / 6–9. The remaining tiles are padding; selecting them does not create a workspace. skip_empty = 1 retains its existing next-empty-workspace tiles and ignores the cap.

Ranges that do not start at 1

center current keeps the grid inside the monitor's own workspace range. That range is the union of the workspaces that currently exist on the monitor and the IDs its workspace rules reserve, for example workspace = 11, monitor:DP-3 or workspace = r[11-20], monitor:DP-3. Reserved IDs count even while they are empty and not yet created, so a monitor bound to 11–20 always starts its grid at 11: opening a columns = 3 overview on workspace 12 shows 11–19 with 11 at the first tile rather than 12–20. Named and compound rules such as name:mail or r[1-5]w[1] reserve no IDs.

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).

With rows = 0 (the default), growth keeps the legacy square grid. With explicit positive rows, only columns grow: columns = 3, rows = 2, first 1 grows to four columns and two rows when workspace 7 is active. Rows are never silently increased. At the seven-column limit this remains best effort, so a one-row grid cannot include an active workspace more than seven slots from its first anchor.

Opening on Every Monitor

By default the overview opens only on the monitor under the cursor. Append all to the dispatcher argument to open one overview per monitor instead:

bind = SUPER, g, hyprexpo:expo, toggle all

Each monitor builds its own grid from its own anchor, so this composes with per-monitor workspace_method. With the placement below, the overview on DP-1 shows workspaces 1-4 and the one on HDMI-1 shows 5-8:

plugin {
    hyprexpo {
        columns = 2
        max_workspace = 8
        workspace_method = DP-1 first 1, HDMI-1 first 5
    }
}

Keyboard navigation has one explicit keyboard owner. Movement stays inside that overview while a valid local tile (including a configured wrap target) exists. At an exhausted edge, the plugin uses global logical geometry to choose the nearest tile in that direction on another monitor. Selecting it switches only the target monitor, then dismisses every open overview.

Window previews can also be dragged between monitor overviews. The monitor under the pointer renders the proxy with the target monitor's own logical tile layout and scale. After a valid drop, source and target thumbnails refresh independently. Releasing over a gap, the source tile, or an invalid target moves nothing; cleanup still removes highlights, restores the cursor, and repaints every monitor visited by the drag.

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.