[Unayung]

Motivation

A --headless session starts on an empty workspace of its own. The windows already open on the remote stay on its physical screens, out of view, so the session does not show the desktop you left at home. Mirroring the physical screen instead shows nothing when that monitor is asleep.

Details

• --move-workspaces (with --headless) is a new server flag. The client takes the same flag and passes it on.
  • When the session starts, every regular workspace moves onto the headless output, and the output shows the workspace the main monitor was showing.
  • When the session ends, each workspace goes back to the monitor it came from, and each monitor shows what it showed before. This happens before the output is removed; left to itself, Hyprland would pile every workspace onto one monitor.
• hypr-ipc gains:
  • workspaces, and Monitor::active_workspace;
  • move_workspace_to_monitor and show_workspace, which go through the same Lua-aware dispatcher helper.

This builds on #57 for that dispatcher helper, so its first commit is that change. Once that merges, only the second commit remains.

Additional information

scripts/check.sh passes. I have not run scripts/e2e.sh. Tested by hand on Hyprland 0.56.2 with a Lua config, a 3440x1440 monitor and a client on macOS: workspaces 1–3 and their windows move onto the headless output and go back to DP-2 on disconnect, and DP-2 shows the workspace it showed before.

🤖 Generated with Claude Code

[greptile-apps]

Confidence Score: 5/5

[Medium impact] The PR appears safe to merge; no blocking issue remains.

Summary

Adds --move-workspaces to bring existing workspaces onto a headless session and return them on disconnect.

• Headless sessions can show remote workspaces and return them afterward.
• Hyprland callers can query and move workspaces through shared helpers.

Diagram

%%{init: {'theme': 'neutral'}}%%
flowchart TD
  A[Create headless output] --> B{Workspace lock available?}
  B -- No --> C[Start without moving workspaces]
  B -- Yes --> D[Save workspace homes and visible workspaces]
  D --> E[Move regular workspaces onto session output]
  E --> F[Session ends]
  F --> G[Stop capture and input]
  G --> H[Return borrowed workspaces and restore visible workspaces]
  H --> I[Remove headless output]

Loading

_{Reviews (6) · Last reviewed commit: "Read a special workspace without an id f..." · Reviewed by Greptile}