Repository files navigation

Loop

Window management made elegant.
Explore Loop »

Download for macOS
~ Compatible with macOS 13 and later. ~

Loop is a macOS app that simplifies window management for you. You can effortlessly choose your window direction using a radial menu triggered by a simple key press, and customize it according to your preferences with personalized colors and settings. You can easily move, resize, and arrange your windows with just a few clicks, saving you valuable time and energy.

The Radial Menu allows you to manipulate windows using your mouse/trackpad. Hold down the trigger key and move your cursor in the desired direction to move and resize the window.

The preview window enables you to see the resize actionbefore committing to it.

Loop allows you to assign any key in tandem with the trigger key to initiate a window manipulation action.

Loop can become very powerful when paired with cycles. These enable you to perform multiple window manipulations in quick succession by pressing the same key combination repeatedly, or by left-clicking repeatedly!

Hide windows at the screen edge to declutter your workspace. Hover near the edge or use a keybind to access them whenever you need.

The radial menu is fully customizable in terms of width, shape, and color. It is also completely optional and can be disabled. Both the cursor interaction and the radial menu itself are independently toggleable.

Adjust the padding, corner radius, border color, and border width of the optional preview window.

brew install loop

Navigate to therelease page and download the latest.zip file located at the bottom, orclick me.

Loop uses a trigger key to function. This key must be held down or pressed to activate certain features within Loop. To access the radial menu, hold down the trigger key and move the cursor in the desired direction. Users who prefer keyboard shortcuts can assign a key to work with the trigger key, activating specific actions. The trigger key can be set in the "Behavior" tab of the "Settings" section. The trigger key can consist of one or multiple keys.

To set Caps Lock as your trigger key, you have two options:

1. Go to System Settings → Keyboard → "Keyboard Shortcuts...".
2. In the "Modifier Keys" tab, remapCaps Lock (⇪) key to(^) Control.
3. Repeat this remapping process for every connected keyboard.
4. In Loop, select theRight Control key as your trigger.

• Hyperkey
• Karabiner Elements

Loop can be controlled via shell commands or AppleScript using its URL scheme:

# Shell examplesopen"loop://direction/right"# Move window to right halfopen"loop://action/maximize"# Maximize windowopen"loop://screen/next"# Move to next screen# AppleScript examplesosascript -e'tell application "Loop" to activate'osascript -e'open location "loop://direction/left"'

You can also create custom scripts to chain multiple actions:

#!/bin/bash# Example: Move window right and then maximizeopen"loop://direction/right"sleep 0.5open"loop://action/maximize"

For a complete list of available commands:

open"loop://list/all"# List all commandsopen"loop://list/actions"# List window actionsopen"loop://list/keybinds"# List custom keybinds

To see all the contributors who have played a significant role in developing Loop, visit ourContributors page.

For an extensive guide on how to contribute, check out thecontributing guide.

This project is licensed under theGNU GPLv3 license.