Skip to main content
Get Loop up and running in minutes and perform your first window management action.

​
Initial setup

1

Install Loop

If you haven’t installed Loop yet, follow the installation guide to get started.
2

Launch Loop

Open Loop from your Applications folder or use Spotlight search (⌘ + Space, then type “Loop”).
3

Grant accessibility permissions

When prompted, grant Loop accessibility permissions in System Settings. This allows Loop to manage your windows.
  1. Click Open System Settings when prompted
  2. Enable the toggle next to Loop
  3. You may need to restart Loop for changes to take effect
4

Set up your trigger key

The trigger key is essential for activating Loop’s features. You can access trigger key settings in the Behavior tab of Loop’s settings.
The trigger key can consist of one or multiple modifier keys. Many users prefer using Caps Lock as their trigger key.
See the trigger key configuration guide for detailed setup instructions.

​
Your first window action

Now that Loop is set up, try your first window management action:
1

Open an application window

Open any application window (Safari, Finder, etc.) that you want to resize or move.
2

Activate the radial menu

Hold down your trigger key and move your cursor. The radial menu will appear, showing different window placement options.
Move your cursor in different directions while holding the trigger key to see the various window positioning options.
3

Choose a window position

While still holding the trigger key, move your cursor in the direction you want to position the window:
  • Left: Snap window to left half
  • Right: Snap window to right half
  • Up: Snap window to top half
  • Down: Snap window to bottom half
  • Corners: Snap window to quarters
4

Release to apply

Release the trigger key to apply the window action. Your window will instantly resize and move to the selected position.
You’ve performed your first window action with Loop!

​
How Loop works

Loop uses a trigger key to function. This key must be held down or pressed to activate features within Loop:
  • Radial menu: Hold down the trigger key and move the cursor in the desired direction to resize and position windows
  • Keyboard shortcuts: Assign keys to work with the trigger key for specific actions (e.g., trigger key + arrow keys)
  • Preview window: See the resize action before committing to it

​
Alternative control methods

Beyond the radial menu, Loop supports several control methods:

​
Keyboard shortcuts

Assign any key combination with your trigger key to perform specific window actions. Configure these in Loop’s settings under the Keybinds tab.

​
Shell and AppleScript

Loop can be controlled via shell commands or AppleScript using its URL scheme: 
# Shell examples
open "loop://direction/right"     # Move window to right half
open "loop://action/maximize"     # Maximize window
open "loop://screen/next"         # Move to next screen

# AppleScript examples
osascript -e 'tell application "Loop" to activate'
osascript -e 'open location "loop://direction/left"'
For a complete list of available commands: 
open "loop://list/all"           # List all commands
open "loop://list/actions"       # List window actions
open "loop://list/keybinds"      # List custom keybinds

​
Next steps

Explore Loop’s powerful features:

Trigger key setup

Learn advanced trigger key configuration options

Features

Discover all of Loop’s window management capabilities

Build docs developers (and LLMs) love

Get started for freeTalk to us