Workspace Relayout

Apply and capture ratio-based Hyprland layouts for the active workspace.

workspace-relayout applies saved layout presets to the active Hyprland workspace. It works on tiled windows only, using ratio-based split trees instead of fixed pixels, so the same preset can fit different monitors, scales, gaps, and bars.

Use it when a workspace has the right windows but the split tree is wrong.

Key bindings

The shared Hypr bindings are:

Presets

Presets are stowed from the dotfiles repo to:

~/.local/share/workspace-relayout/presets.json

They are grouped by tiled window count under layouts.<count>. Preset version 3 gives each layout a family, a concise scale label, and a generic split tree:

{
  "group": "Top / bottom",
  "name": "75% top",
  "tree": {
    "dir": "tb",
    "ratio": 75.4,
    "a": "w",
    "b": {
      "dir": "lr",
      "ratio": 40.67,
      "a": "w",
      "b": "w"
    }
  }
}

The checked-in presets cover workspaces with two to five tiled windows. Their JSON order controls both the family menu and the presets within each family. Common top/bottom layouts come first, ordered from the largest top region down. Other families distinguish columns, left or right stacks, and purpose-specific arrangements.

Preset names do not need to be unique. The menu appends a rounded ratio signature, such as 75% top [75/25, 16/16/16/52], to distinguish variants.

The script writes back through the stowed symlink when you edit presets, keeping the symlink in place.

Apply a layout

1. Focus the workspace to relayout.
2. Keep at least two tiled, mapped, non-hidden windows on that workspace.
3. Press SUPER+TAB.
4. Choose a layout family from the Omarchy menu, such as Top / bottom or Left / right.
5. Choose an ordered scale preset from that family.
6. Let the script move windows through the temporary workspace and rebuild the split tree.

The script restores focus to the previously active window when it can.

Capture a new preset

Use edit mode when the current workspace already has the layout you want to save:

workspace-relayout --edit

Or press:

SUPER+ALT+TAB

Edit mode reconstructs the current layout into a split tree. Choose a family first, then overwrite one of its presets or add a new layout to it using the generated description or a custom name. Choose Add new family to name a new family and save the current layout as its first preset.

Temporary workspace

Relayout rebuilds the split tree by moving windows through a temporary workspace. The default temporary workspace is 99.

Override it only when workspace 99 is already used for something important:

WORKSPACE_RELAYOUT_TEMP_WS=98 workspace-relayout

The temp workspace must be a positive numeric workspace id and must not match the active workspace.

Requirements

workspace-relayout requires:

• hyprctl
• jq
• awk
• omarchy-menu-select
• omarchy-menu-input
• The presets file at ~/.local/share/workspace-relayout/presets.json

If a requirement is missing, the script sends a desktop notification and exits.

Troubleshooting

If the menu says there are no presets, the active workspace has a window count that is not present in presets.json. Use edit mode to save the current arrangement for that count.

If the script says it needs at least two windows, make sure the windows are tiled. Floating windows are ignored.

If a layout applies but the order feels wrong, rearrange the windows manually and save a preset in edit mode. The assignment logic keeps windows near their current target positions, but windows are still treated as interchangeable leaves.

Reset

There is no persistent Hyprland state to reset. To recover from a bad relayout, use Hyprland’s normal move/split controls, apply another preset, or restore a saved workspace session from Workspace Session Recovery.