> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/mrkai77/loop/llms.txt
> Use this file to discover all available pages before exploring further.

# Loop - Elegant Window Management

> Loop is a macOS app that simplifies window management with an intuitive radial menu, powerful keyboard shortcuts, and extensive customization options.

<img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/mrkai77-loop/images/loop-logo-light.png" alt="Loop Logo" width="200" height="200" />

<img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/mrkai77-loop/images/loop-logo-dark.png" alt="Loop Logo" width="200" height="200" />

# Window Management Made Elegant

Loop is a macOS app that simplifies window management for you. 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.
</Note>

## Quick Start

Get started with Loop in minutes:

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/getting-started/installation">
    Download Loop via Homebrew or direct download. Compatible with macOS 13+.
  </Card>

  <Card title="Quickstart Guide" icon="rocket" href="/getting-started/quickstart">
    Learn the basics and start managing windows in under 5 minutes.
  </Card>

  <Card title="Core Features" icon="stars" href="/features">
    Explore radial menu, keyboard shortcuts, cycles, stash, and more.
  </Card>

  <Card title="API Reference" icon="code" href="/api/window-directions">
    Automate Loop with URL schemes and AppleScript.
  </Card>
</CardGroup>

## Key Features

### Radial Menu

The radial menu allows you to manipulate windows using your mouse or trackpad. Hold down the trigger key and move your cursor in the desired direction to move and resize windows intuitively.

<Card title="Learn more about Radial Menu" icon="circle-dot" href="/features/radial-menu">
  Discover how to use the radial menu for intuitive window positioning.
</Card>

### Keyboard Shortcuts

Assign any key combination with the trigger key to initiate window manipulation actions. Loop supports dozens of pre-configured actions including halves, quarters, thirds, and custom positions.

<Card title="Explore Keyboard Shortcuts" icon="keyboard" href="/features/keyboard-shortcuts">
  Master keyboard shortcuts for lightning-fast window management.
</Card>

### Cycles (Action Sequences)

Perform multiple window manipulations in quick succession by pressing the same key combination repeatedly. Create powerful workflows that adapt to your needs.

<Card title="Master Cycles" icon="rotate" href="/features/cycles">
  Learn how to create action sequences for advanced workflows.
</Card>

### Stash

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

<Card title="Use Stash" icon="box-archive" href="/features/stash">
  Organize your workspace by stashing windows at screen edges.
</Card>

### Live Preview

See the resize action before committing to it with the preview window. Fully customizable with padding, corner radius, border color, and border width options.

<Card title="Configure Preview" icon="eye" href="/features/preview">
  Customize the preview window to match your preferences.
</Card>

### Theming & Customization

The radial menu and preview window are fully customizable. Adjust width, shape, colors, padding, corner radius, and more to match your aesthetic preferences.

<Card title="Customize Theme" icon="palette" href="/features/theming">
  Personalize Loop's appearance with extensive theming options.
</Card>

### Custom Frames & Positions

Create custom window positions and sizes tailored to your workflow. Define exact coordinates or use percentage-based layouts.

<Card title="Create Custom Actions" icon="window-restore" href="/configuration/custom-actions">
  Build custom window positions for your unique workflow.
</Card>

### Multi-Screen Support

Move windows across multiple displays with dedicated screen-switching actions. Supports next/previous screen, directional screen selection, and more.

<Card title="Multi-Screen Setup" icon="display" href="/api/screen-switching">
  Learn about screen-switching commands for multi-display setups.
</Card>

### Automation

Control Loop programmatically via URL schemes and AppleScript. Integrate with automation tools like Keyboard Maestro, Alfred, and shell scripts.

<CardGroup cols={2}>
  <Card title="URL Scheme" icon="link" href="/advanced/url-scheme">
    Trigger actions via `loop://` URLs.
  </Card>

  <Card title="AppleScript" icon="terminal" href="/advanced/applescript">
    Automate Loop with AppleScript commands.
  </Card>
</CardGroup>

## System Requirements

<Info>
  Loop is compatible with **macOS 13 (Ventura) and later**.
</Info>

## Open Source

Loop is free and open source under the GNU GPLv3 license. Contributions are welcome!

<CardGroup cols={2}>
  <Card title="GitHub Repository" icon="github" href="https://github.com/MrKai77/Loop">
    View the source code and contribute to Loop.
  </Card>

  <Card title="Join Discord" icon="discord" href="https://discord.gg/2CZ2N6PKjq">
    Connect with the Loop community on Discord.
  </Card>
</CardGroup>

## What's Next?

<CardGroup cols={2}>
  <Card title="Installation" icon="download" href="/getting-started/installation">
    Install Loop and grant necessary permissions.
  </Card>

  <Card title="Quickstart" icon="play" href="/getting-started/quickstart">
    Complete the quickstart guide to learn the basics.
  </Card>

  <Card title="Configure Trigger Key" icon="key" href="/getting-started/trigger-key">
    Set up your trigger key for optimal workflow.
  </Card>

  <Card title="Explore Features" icon="compass" href="/features">
    Dive deep into all of Loop's powerful features.
  </Card>
</CardGroup>
