Reproducing MacOS' Aerospace 'move-workspace-to-monitor --wrap-around next' in hyprland

Unknown — Sat, 28 Mar 2026 00:00:00 +0000

Introduction</h2>
Aerospace</a> is a tiling window manager for MacOS. One of its handy features is `move-workspace-to-monitor --wrap-around next</code>, which moves the current workspace to the next monitor and wraps around when reaching the last one.</p>`
`This guide (more like me dumping this script on the internet) shows you how to replicate this behavior in` `Hyprland</a>, a dynamic tiling Wayland compositor.</p>`

Prerequisites</h2>

Hyprland</strong> - includes hyprctl</code> by default</li>
jq</strong> - JSON processor used to parse hyprctl</code> output</li>
</ul>
The Script</h2>
Add this script somewhere on your system, and make it executable.</p>
#!/usr/bin/env bash</span></span>
</span>
ACTIVE_WS_JSON</span>=</span>$(</span>hyprctl</span> activeworkspace -j</span>)</span></span>
</span>
WS_ID</span>=</span>$(</span>echo</span> "</span>$ACTIVE_WS_JSON</span>"</span> |</span> jq</span> -r</span> '</span>.id</span>')</span></span>
CURRENT_MON</span>=</span>$(</span>echo</span> "</span>$ACTIVE_WS_JSON</span>"</span> |</span> jq</span> -r</span> '</span>.monitor</span>')</span></span>
</span>
# read lines and put in array MONITORS</span></span>
mapfile</span> -t MONITORS</span> <</span> <(</span>hyprctl</span> monitors -j</span> |</span> jq</span> -r</span> '</span>.[].name</span>')</span></span>
</span>
for</span> i</span> in</span> "</span>${!</span>MONITORS</span>[</span>@</span>]</span>}</span>"</span>; do</span></span>
  if</span> [[ "</span>${</span>MONITORS</span>[</span>$i</span>]</span>}</span>"</span> ==</span> "</span>$CURRENT_MON</span>" ]]</span>; then</span></span>
    CURRENT_INDEX</span>=</span>$i</span></span>
    break</span></span>
  fi</span></span>
done</span></span>
</span>
NEXT_INDEX</span>=</span>$(( (</span>CURRENT_INDEX</span> +</span> 1</span>)</span> %</span> ${#</span>MONITORS</span>[</span>@</span>]</span>}</span> ))</span></span>
NEXT_MON</span>=</span>"</span>${</span>MONITORS</span>[</span>$NEXT_INDEX</span>]</span>}</span>"</span></span>
</span>
hyprctl</span> dispatch moveworkspacetomonitor</span> "</span>$WS_ID</span>" "</span>$NEXT_MON</span>"</span></span></code></pre>How It Works</h2>

Get active workspace info: hyprctl activeworkspace -j</code> returns JSON with the current workspace ID and monitor name</li>
Extract workspace ID and monitor: jq</code> parses the JSON to get .id</code> and .monitor</code></li>
Build monitor list: hyprctl monitors -j</code> returns all connected monitors, which we store in an array</li>
Find current monitor index: Loop through the array to find where the current monitor is positioned</li>
Calculate next monitor: Using modulo arithmetic (current + 1) % total</code> gives us the next index, wrapping around to 0 when at the end</li>
Move workspace: hyprctl dispatch moveworkspacetomonitor</code> moves the workspace to the target monitor</li>
</ol>
Keybinding</h2>
Then bind it to a keyboard shortcut:</p>
$mainMod = ALT # Sets "ALT" key as main modifier</span></span>
bind = $mainMod SHIFT, TAB, exec, <SCRIPT_FOLDER>/move_workspace_to_next_monitor.sh</span></span>
</span>
# now ALT + SHIFT + TAB will move your current workspace to the next screen.</span></span></code></pre>

Théophile Roos - My Blog

Reproducing MacOS' Aerospace 'move-workspace-to-monitor --wrap-around next' in hyprland

How to create python GRPC stub with buf with local plugins

Configuring udev rules for the ZSA voyager on nixos