Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mrkai77/loop

Window management made elegant.
https://github.com/mrkai77/loop

hacktoberfest macos macos-app menu productivity radial-menu swift swiftui window-management

Last synced: about 4 hours ago
JSON representation

Window management made elegant.

Awesome Lists containing this project

README

        


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!

### 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

```bash
brew install loop
```

#### Manual Download

Navigate to the [release page](https://github.com/MrKai77/Loop/releases/latest) and download the latest `.zip` file located at the bottom, or [click me](https://github.com/MrKai77/Loop/releases/latest/download/Loop.zip).

### 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

- [Hyperkey](https://hyperkey.app/)
- [Karabiner Elements](https://karabiner-elements.pqrs.org/)

### 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


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

## Contributors

To see all the contributors who have played a significant role in developing Loop, visit our [Contributors](CONTRIBUTORS.md) page.

### How to Contribute

For an extensive guide on how to contribute, check out the [contributing guide](CONTRIBUTING.md).

## FAQ

### Comparison

App NameLoopRectangle  ProHammerspoon1PieceBetterTouchToolSwishRectangleMultitouchEmmetappAmethystWindow  FusionTilesMagnetMoomWinsYabaiMacOS  15
PriceFree$9.99FreeFree$22$16Free$15.99$19Free$12Free$4.99$10$13.99FreeFree
Preview$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$
Restore Size$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$
Open Source$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$
Edge Snapping$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$
Set Custom Size$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$
Save Workspace$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$
Percentage Units$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$
Modifier + Mouse$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$
Modifier + Arrows$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$
Maximize Window$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$
Multi-Screen Move$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$
Touchpad Gestures$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$
Modifier + Touchpad$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$
Margin / Grid Padding$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$
Pin/Unpin window on top$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$
Resize Adjacent Windows$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$
Open  Window  On  Set  Screen$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{red}{\textsf{✗}}$$\color{green}{\textsf{✓}}$$\color{red}{\textsf{✗}}$

### License

This project is licensed under the [GNU GPLv3 license](LICENSE).