Workspaces

Overview

Workspaces let you save a named window arrangement — positions, sizes, display assignments, and z-order — and restore it with a single hotkey. Up to 9 workspaces can be activated instantly via Mod+1 through Mod+9.

Creating a Workspace

1. Arrange your windows the way you want them.
2. Menu bar > Workspaces > Save Current as Workspace...
3. Enter a name (e.g., "Coding", "Writing", "Browsing").
4. All currently visible windows are saved with their positions and display assignments.

Activating a Workspace

When you activate a workspace:

1. Non-member windows are minimized to the dock.
2. Member windows are unminimized, positioned, and raised in their saved z-order.
3. Apps that aren't running show as missing entries (with a Launch button in the Organizer).

Ways to activate:

• Press Mod+1 through Mod+9 (workspace order matches Settings > Workspaces list).
• Menu bar > Workspaces > click the workspace name.
• Quick Switcher > click a workspace chip at the top.
• Organizer sidebar > click the workspace, then context menu > Activate.

Display Configurations

Workspaces are tied to the display configuration (monitor count and resolutions) that was active when they were saved. The menu bar and Quick Switcher label workspaces as:

• Available Now — Matches your current display setup.
• Other Display Setups — Saved on a different configuration. You can still activate them, but window placement may not be exact.

Updating a Workspace

After rearranging windows, you have two options:

• Full replacement — Menu bar > Workspaces > Update Current Workspace. Replaces all entries with the current visible windows.
• Additive merge — Organizer > right-click the workspace > Merge Visible Windows. Adds new windows without removing existing entries.

Managing Entries

In the Organizer's workspace view:

• Missing entries show with a warning icon and "Launch" button.
• Click the trash icon to remove individual entries.
• Right-click the workspace > Remove All Missing to clean up stale entries.

Geometry Propagation

When you manually move or resize a window that belongs to a workspace, WinPin automatically updates that workspace entry to reflect the new geometry. This happens transparently during auto-capture — your workspaces stay current without manual updates.

Reordering

Drag workspaces in Settings > Workspaces to change their order. The order determines which Mod+N hotkey activates which workspace.