Loop README

The project's README from github.com/mrkai77/Loop. As one markdown file: README.md.

Logo

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.

[!NOTE]

Loop is constantly evolving, with new features and improvements added regularly to enhance your window management experience on macOS.

Loop Demo


Features

Radial Menu

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.

Preview

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

Keyboard Shortcuts

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

Cycles

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!

Stash

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

Theming

Radial Menu

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.

Preview

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

Usage

Installation

Homebrew

brew install loop

Manual Download

Navigate to the release page and download the latest .zip file located at the bottom, or click me.

Triggering

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:

a. Change System Settings

  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.

b. Use an external App

c. Shell/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"'

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

Keyboard Shortcuts

Category Actions
General Fullscreen, Maximize, Almost Maximize, Centre, MacOS Centre, Minimize, Hide
Halves Top Half, Bottom Half, Left Half, Right Half
Quarters Top Left Quarter, Top Right Quarter, Bottom Left Quarter, Bottom Right Quarter
Horizontal Thirds Right Third, Right Two Thirds, Horizontal Center Third, Left Two Thirds, Left Third
Vertical Thirds Top Third, Top Two Thirds, Vertical Center Third, Bottom Two Thirds, Bottom Third
Screen Switching Next Screen, Previous Screen, Left Screen, Right Screen, Top Screen, Bottom Screen
Window Manipulation Larger, Smaller, Shrink Top, Shrink Bottom, Shrink Right, Shrink Left, Grow Top, Grow Bottom, Grow Right, Grow Left, Move Up, Move Down, Move Right, Move Left
More Initial Frame, Undo, Custom, Cycle

FAQ

Comparison

Loop macOS 15+ Rectangle Pro Rectangle Magnet Moom Swish BetterTouchTool Multitouch Hammerspoon Yabai Amethyst AeroSpace 1Piece Wins MacsyZones
Price Free Free $9.99 Free $4.99 $15.00 $16.00 $14.00 $15.99 Free Free Free Free Free $13.99 Free
Open Source ✅ ❌ ❌ ✅ ❌ ❌ ❌ ❌ ❌ ✅ ✅ ✅ ✅ ❌ ❌ ✅
Custom Frames ✅ ❌ ✅ ❌ ❌ ✅ ❌ ✅ ❌ ✅ ✅ ✅ ❌ ✅ ❌ ✅
Preview Window ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ✅ ❌ ❌ ✅ ✅ ❌
Theming Options ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌
Modifier + Mouse ✅ ❌ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ✅
Modifier + Arrows ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ✅ ✅ ❌ ✅ ✅
Modifier + Trackpad ✅ ❌ ✅ ❌ ❌ ❌ ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ✅
Trackpad Gestures ❌ ❌ ✅ ❌ ✅ ❌ ✅ ✅ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ✅
Padding / Margins ✅ ✅ ✅ ✅ ❌ ✅ ✅ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ✅ ✅
Stashed Windows ✅ ❌ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ✅ ❌ ❌ ❌ ❌ ❌ ❌
Save Workspace ❌ ❌ ✅ ❌ ❌ ✅ ❌ ❌ ❌ ✅ ❌ ✅ ❌ ✅ ❌ ✅
Restore Initial Frame ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌ ✅ ✅ ✅
Pin Windows On Top ❌ ❌ ❌ ❌ ❌ ❌ ❌ ✅ ❌ ❌ ✅ ✅ ❌ ❌ ❌ ❌
Snap Windows via Drag ✅ ✅ ✅ ✅ ✅ ✅ ❌ ✅ ✅ ✅ ❌ ❌ ❌ ✅ ✅ ❌
Resize Adjacent Windows ❌ ✅ ✅ ❌ ✅ ❌ ✅ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ❌ ✅
Action Sequences (Cycles) ✅ ❌ ✅ ✅ ❌ ✅ ❌ ✅ ❌ ✅ ❌ ❌ ❌ ❌ ❌ ❌
Move Windows Across Screens ✅ ✅ ✅ ✅ ❌ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ✅ ❌
Switch Focus Between Windows ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ❌ ✅ ✅ ✅ ✅ ✅ ❌ ✅
Scripting (URL / AppleScript or other) ✅ ✅ ✅ ✅ ❌ ✅ ❌ ✅ ❌ ✅ ✅ ❌ ✅ ✅ ❌ ❌

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.

How to Contribute

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

License

This project is licensed under the GNU GPLv3 license.

Loop (mrkai77/Loop)

Searching Database…

11.8K ·GitHub
Loop
这是什么？Loop 是一款 macOS 应用，通过径向菜单、键盘快捷键或鼠标手势来简化窗口管理，让你可以移动、调整大小和排列窗口。
它是取代 macOS 的窗口管理器，还是和 macOS 一起运行？它作为普通应用与 macOS 一起运行，通过你按住的一个按键来触发，而不是像 Yabai 那样完全取代的窗口管理器。
我需要哪个版本的 macOS？Loop 需要 macOS 13 或更高版本。
我能把大写锁定键当作触发键吗？可以，但不能直接设置。你必须在系统设置中，为每个连接的键盘把大写锁定键改成控制键（Control），或者使用 Hyperkey、Karabiner Elements 等外部应用。
径向菜单到底是什么？这是一个用鼠标或触控板操作的菜单。按住触发键并把光标朝某个方向移动，就可以朝那个方向移动或调整窗口大小。
循环操作是什么？循环操作让你通过重复按同一组快捷键或左键单击，把多个窗口操作串联起来，让重复的动作彼此叠加。
Stash 功能是什么？Stash 可以把窗口隐藏到屏幕边缘，让工作区更整洁。之后只需把光标悬停在屏幕边缘附近，或使用快捷键，就能把窗口重新显示出来。
Loop 和 Rectangle、Magnet 相比怎么样？Loop 和 Rectangle 一样免费开源，并且增加了主题选项、带修饰键加鼠标控制的径向菜单，以及大多数付费替代品（如 Magnet、Moom 和 Swish）所缺乏的操作循环功能。
可以用脚本控制 Loop 吗？可以。Loop 提供 URL scheme，因此可以通过 shell 命令或 AppleScript 来控制，还能把多个操作串联在一起。
What are similar projects?DockDoor, tinycast, Sapphire, KiwiDesk, Ice, pliss, WallpaperMachine, glazewm
Which topics is it in?window-management, keyboard, menu-bar, swiftui, macos-app, swift, shell, customization, productivity, gui, desktop-app, macos
Creator
mrkai77
Size
355.9 MB
Stars
11.8K
Updated
CommitOct 13Release1.4.2Jan 26
Age
3y
Commits · 90 Days