Troubleshooting: Window Restore

Windows Don't Restore After Sleep/Wake

Display Stability Delay

After sleep/wake or a display change, WinPin waits 2-3 seconds for macOS to stabilize the display configuration before restoring. If your displays take longer to initialize (some Thunderbolt docks are slow), the restore may fire before the display is fully ready.

Fix: Wait a few seconds, then use menu bar > Restore Now to manually trigger a restore.

Auto-Capture Was Off

WinPin only restores what it has captured. If Auto-Capture was toggled off when you last rearranged your windows, there's nothing to restore.

Fix: Ensure Auto-Capture is enabled (menu bar toggle or Settings > General). You can also press Capture Now after arranging windows to force a save.

Windows Restore to Wrong Positions

Display Configuration Changed

Window layouts are saved per display configuration (identified by resolution keys like "1920x1080+2560x1440"). If you changed your monitor setup — different resolution, different monitor count — WinPin starts fresh for that configuration.

Fix: Arrange your windows once on the new configuration, and WinPin will capture and remember them going forward.

Window Identity Confusion

WinPin identifies windows by a combination of app name, window size, and a session UUID. If you have multiple windows of the same app at the same size, WinPin's nudge system widens one by a few pixels to create unique identifiers.

If an app rejects resizing (some apps enforce fixed window sizes), WinPin blacklists that app from nudging. In this case, same-size windows from the same app may be swapped during restore.

Workspace Shows Missing Windows

Missing entries mean the app isn't running. In the Organizer:

Click Launch to start the app.
Click the trash icon to remove stale entries.
Right-click the workspace > Remove All Missing to clean up.

If an app is running but still shows as missing, the app may have changed its bundle identifier (e.g., after an update). Delete the stale entry and re-add the window via right-click > Add to Workspace.