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 как обычное приложение, которое запускается, когда вы удерживаете клавишу, а не является полноценной заменой оконного менеджера вроде Yabai.
Какая версия macOS мне нужна?Loop требует macOS 13 или новее.
Могу ли я использовать Caps Lock как клавишу запуска?Да, но не напрямую: нужно переназначить Caps Lock на Control в Системных настройках для каждой подключённой клавиатуры или использовать стороннее приложение, например Hyperkey или Karabiner Elements.
Что именно представляет собой радиальное меню?Это меню, которым управляют мышью или трекпадом: его открывают, удерживая клавишу запуска и двигая курсор в нужную сторону, чтобы переместить или изменить размер окна в этом направлении.
Что такое Cycles?Cycles позволяют объединять несколько действий с окном: достаточно повторно нажимать одну и ту же комбинацию клавиш или щёлкать левой кнопкой мыши, и каждое повторное действие будет строиться на предыдущем.
Что такое Stash?Stash позволяет прятать окна у края экрана, чтобы освободить рабочее пространство, а затем возвращать их, наведя курсор на край экрана или используя горячую клавишу.
Чем Loop отличается от Rectangle или Magnet?Loop, как и Rectangle, бесплатный и с открытым исходным кодом, но добавляет настройку оформления, радиальное меню с управлением через клавишу-модификатор и мышь, а также циклы действий, которых нет у большинства платных альтернатив, таких как Magnet, Moom и Swish.
Можно ли управлять Loop с помощью скриптов?Да, Loop предоставляет URL-схему, поэтому им можно управлять через команды оболочки или AppleScript, в том числе объединяя несколько действий в цепочку.
What are similar projects?DockDoor, tinycast, Sapphire, KiwiDesk, Ice, dimble, 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