Radial Menu

Use your mouse or trackpad to manipulate windows with Loop’s intuitive radial menu interface

Overview

The Radial Menu is Loop’s signature visual interface that allows you to manipulate windows using your mouse or trackpad. By holding down the trigger key and moving your cursor in the desired direction, you can quickly resize and reposition windows without memorizing complex keyboard shortcuts.

How It Works

The radial menu appears at your cursor position (or screen center, if configured) when you hold down the trigger key. As you move your cursor, the menu highlights the corresponding window action based on the direction and distance from the center.

Basic Usage

1. Hold the trigger key

   Press and hold your configured trigger key (set in Settings > Keybinds)

2. Move your cursor

   Move your mouse or trackpad in the direction you want to resize the window

3. Release to apply

   Release the trigger key to apply the selected window action

Direction Mapping

The radial menu intelligently maps cursor directions to window actions:

• Cardinal directions: Left, Right, Top, Bottom for halves
• Diagonal movements: Corners for quarters
• Outward from center: Maximize/fullscreen actions
• Custom positions: User-defined actions can be placed at specific angles

Implementation Details

The radial menu is implemented in the RadialMenuController class, which creates a borderless, non-activating panel that floats above all windows:

Loop/Window Action Indicators/Radial Menu/RadialMenuController.swift

func open(context: ResizeContext) {
    let panel = ActivePanel(
        contentRect: .zero,
        styleMask: [.borderless, .nonactivatingPanel],
        backing: .buffered,
        defer: true
    )
    
    panel.ignoresMouseEvents = true
    panel.collectionBehavior = .canJoinAllSpaces
    panel.level = .screenSaver
}

Positioning Modes

The radial menu can be positioned in two ways:

Cursor Position (Default)

if Defaults[.lockRadialMenuToCenter], let screen = NSScreen.main {
    // Position at cursor
    panel.setFrameOrigin(
        NSPoint(
            x: mouseX - windowSize / 2,
            y: mouseY - windowSize / 2
        )
    )
}

Configuration Options

Visual Customization

Navigate to Settings > Theming > Radial Menu to customize the appearance:

Radial menu · toggle · default: "enabled"

Enable or disable the radial menu visualization. When disabled, you can still use cursor directions, but without the visual indicator.

Corner radius · number · default: "40"

Adjust the roundness of the radial menu segments (30-50 pixels)

Thickness · number · default: "20"

Control the thickness of the radial menu ring (10-35 pixels)

Action Customization

You can customize which actions appear in the radial menu:

1. Enable customization

   In Settings > Theming > Radial Menu, enable custom actions

2. Add actions

   Click “Add” to insert new radial menu actions

3. Configure direction

   Set the direction and position for each action

4. Reorder

   Drag actions to change their priority and arrangement

Left-click on cycle actions in the radial menu to step through the cycle items sequentially.

Advanced Features

Independent Cursor Interaction

The radial menu and cursor interaction can be toggled independently:

• Radial menu only: Visual feedback without cursor-based triggering
• Cursor interaction only: Invisible directional controls
• Both enabled: Full visual and interactive experience

This flexibility allows you to customize Loop to match your workflow preferences.

Multi-Screen Support

The radial menu automatically adjusts to work across multiple displays:

panel.collectionBehavior = .canJoinAllSpaces

This ensures the menu appears correctly regardless of which screen or space you’re working in.

The radial menu requires accessibility permissions to function. Make sure Loop has the necessary permissions in System Settings > Privacy & Security > Accessibility.

Disabling the Radial Menu

If you prefer keyboard-only workflows, you can completely disable the radial menu:

1. Open Settings > Theming > Radial Menu
2. Toggle off “Radial menu”
3. The visual indicator will disappear, but keyboard shortcuts will continue to work

This is useful for users who:

• Prefer minimal visual distractions
• Use Loop exclusively with keyboard shortcuts
• Want to reduce system resource usage