Permissions and system settings
Complete the operating-system setup shown at first launch so Corral can manage your windows.
Required permissions on macOS
| Permission | Why it is needed |
|---|---|
| Accessibility | Manages window positions and sizes. |
| Input Monitoring | Detects hovering over or right-clicking the green window button. |
- Choose Open next to the permission.
- Allow the corresponding permission for Corral in System Settings.
- Return to Corral and recheck all permissions.
Windows Snap windows setting
Choose Open in Corral’s prompt to open Windows settings, then turn off Snap windows so Corral can manage window placement directly.
If PowerToys FancyZones is enabled, both tools may try to place the same window. Disable FancyZones or quit PowerToys before using Corral Window Snap.
Avoid running FancyZones alongside Corral snapping
- Open the system tray at the right of the taskbar.
- Right-click PowerToys and open its settings.
- Under its window-management category, open FancyZones and turn it off. Alternatively, quit PowerToys from the tray.
- Return to Corral, recheck the status, and drag a normal window.
Read the permission status
| Status | Meaning | Next step |
|---|---|---|
| Checking | Corral is reading the current system state. | Wait for the check to finish. |
| Action needed | Required setup is not complete. | Open the relevant setting and complete it. |
| Permission check error | Corral could not determine the current state. | Check system settings directly, then recheck all permissions. |
| Granted | The checked permission requirement is satisfied. | Apply an arrangement to a normal window to confirm actual behavior. |
On macOS, automatic checking runs for up to five minutes. If it times out, recheck manually. You do not need to disable system security as a whole to resolve a permission error.
Confirm that setup worked
Check that the required permissions show as granted. If an action-required state or error remains, inspect the corresponding setting and recheck it.
When setup is complete, continue to arranging your first window.