mrkai77/Loop

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 action before 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 the release page and download the latest .zip file located at the bottom, or click 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, remap Caps Lock (⇪) key to (^) Control.
3. Repeat this remapping process for every connected keyboard.
4. In Loop, select the Right Control key as your trigger.

• Hyperkey
• Karabiner Elements

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"'

You can also create custom scripts to chain multiple actions:

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

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

Information was gathered from each app’s official website and other online sources and may be outdated. If you notice any inaccuracies, please open an issue or contact the maintainers. Special thanks to the Definitive MacApp Comparisons spreadsheet.

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

This project is licensed under the GNU GPLv3 license.