Troubleshooting: Permissions

Accessibility Permission

WinPin requires Accessibility permission to move, resize, minimize, and restore windows. Without it, WinPin can only see window positions (via CoreGraphics) but cannot manipulate them.

Symptoms When Missing

• Tiling, restore, and workspace activation do nothing.
• The menu bar shows "Grant Accessibility..." instead of "Granted".
• The Organizer can list windows but Focus, Minimize, and tile actions fail.

How to Grant

1. Click Grant Accessibility... in the WinPin menu bar.
2. System Settings > Privacy & Security > Accessibility.
3. Toggle WinPin on (or click the + button to add it).
4. Restart WinPin — macOS requires a restart for the permission to take effect.

If It Still Doesn't Work

• Remove WinPin from the Accessibility list, restart, then re-add it.
• Check that you're granting permission to the correct WinPin binary (not an old version in a different location).

Screen Recording Permission

WinPin uses Screen Recording permission to read window titles via CGWindowListCopyWindowInfo. Without it, windows appear with blank titles.

Symptoms When Missing

• Window titles show as empty in the Quick Switcher and Organizer.
• Fuzzy search can only match on app names, not window titles.
• The menu bar shows "Grant Screen Recording..." instead of "Granted".

How to Grant

1. Click Grant Screen Recording... in the WinPin menu bar.
2. System Settings > Privacy & Security > Screen Recording.
3. Toggle WinPin on.
4. Restart WinPin.

After Granting Permissions

Both permissions require an app restart. After granting:

1. Quit WinPin (menu bar > Quit).
2. Relaunch WinPin.
3. Verify both show "Granted" in the menu bar.