# Set up Glidro

For Glidro 1.1.0. The app is Developer ID signed and notarized by Apple; release availability is shown on [Payhip](https://payhip.com/b/HsS5T).

## Requirements

- Apple silicon Mac (M1 or newer), macOS 13 Ventura or later.
- Accessibility access through Glidro's guided onboarding. No SIP changes are required.
- A built-in trackpad or Magic Trackpad for multi-finger gestures.

## Install and activate

1. Download the available release from your Payhip receipt and download page.
2. Move Glidro into Applications and open it from there.
3. Enter the license key delivered through Payhip. One key supports **one active Mac**. Deactivate the old Mac before moving your license.
4. Follow the app's Accessibility onboarding. The signed and notarized app uses the normal macOS install flow. Open Glidro from Applications and follow the permission steps.

## Allow Accessibility

Grant **Glidro** Accessibility access first in System Settings → Privacy & Security → Accessibility. Then return to onboarding and follow the engine access step if requested. If Glidro asks for separate helper access, enable **Glidro Engine**. Use **Show Engine** or **Repair Access** in Settings when permission help is needed. If macOS retained a stale entry after the app moved or was replaced, remove that entry and re-add the app or helper from its current location. Use **Resume** in the menu bar after permissions are ready.

## Set up your scrolling layout

Open Glidro from the menu bar. **Workspaces** shows your windows. Glidro uses a horizontal scrolling strip with stable column widths. Native fullscreen windows keep their own macOS behavior.

In **Layout**, adjust gaps, focus behavior and new-window placement. New windows open beside the focused window by default; placement at the end is configurable. Scrolling width presets start at **25%, 35%, 65% and 75%**. **Option+R** cycles presets, **Option+F** toggles full width, and **Option+C** centers an interior column. The first and last columns stay pinned to the strip edges.

## Configure trackpad gestures

Fresh installs enable four-finger window swipes. Use **Controls → Trackpad** to choose three or four fingers, direction and sensitivity. Movement follows your chosen sensitivity; it is not a promise of one-to-one finger movement. Workspace gestures are a separate option.

Avoid using the same gesture for macOS desktop switching. In System Settings → Trackpad → More Gestures, turn off **Swipe between full-screen applications** for four-finger Glidro navigation, or reserve four fingers for macOS and choose three fingers in Glidro. For three-finger Glidro swipes, turn off Three Finger Drag under Accessibility → Pointer Control → Trackpad Options, and use two fingers for Swipe between pages. System behavior varies; test the combination on your Mac. Mission Control and App Exposé use vertical gestures.

## Configure macOS

In System Settings → Desktop & Dock → Mission Control, turn off **Automatically rearrange Spaces based on most recent use**, and turn on **Displays have separate Spaces**. Log out if macOS requests it. Turn off Stage Manager while Glidro manages your windows.

On macOS 15 and later, disable competing window-tiling drag gestures in Desktop & Dock → Windows. Display arrangements work side by side or vertically; macOS can constrain how far windows move toward another display.

## Find settings and shortcuts

The app's pages are **Workspaces, Layout, Controls, Apps, Settings and Help**. **Controls → Keyboard** records custom shortcuts, with several bindings per action. **Option+D** toggles a tabbed column. **Control+Option+Shift+=** selects the next width preset; **Control+Option+Shift+-** selects a smaller width preset. Existing custom bindings take priority when missing actions receive available shipped defaults.

**Apps** includes or excludes apps from tiling; fixed strip slots are not a current feature. Hold **Fn** for native drag/drop, with edge insertion and configurable center behavior. The website demo uses simplified dragging.

## Control reference

**Menu bar** — Workspace numbers switch workspaces; their visibility is configurable. Quick Settings toggles focus follows pointer, focus border, dim other windows and trackpad gestures.

**Workspaces → Workspace options** — Choose the starting workspace, remember focus in each workspace, skip empty workspaces with Next/Previous, wrap at the first and last workspace, return to the previous workspace when selecting the current one, and include empty workspaces in Overview.

**Layout → Focus appearance** — Focus follows pointer is optional and off by default. Enable a focus border or dim other windows, then adjust dimming strength.

**Layout → Advanced** — Choose new-window insertion beside the focused window or at the end, and whether to balance new tiles. Drag and Drop can be enabled or disabled; choose Fn (the default), Option, Control, Command or Shift as the drag modifier. Choose center-drop swap or stack, adjust the edge drop zone, and toggle the drop preview.

**Layout → Advanced → Stack Indicators** — Show or hide stack indicators; choose click-to-focus or hover highlighting, top/bottom for horizontal stacks and left/right for vertical stacks, plus thickness and spacing.

**The control window and Pause** — Closing the control window leaves the engine running. With Glidro active, Window → Open Glidro (Command+0) reopens it. The title-bar button collapses or expands the sidebar. Pause stops tiling and restores original positions and sizes for managed windows that can be restored safely; intentional Pause stays paused. Quit waits for restoration, with a bounded timeout.

**Help** — Copy details includes the Glidro version/build, macOS version and engine status. It does not read window titles, configuration or license keys. What’s new shows bundled release notes when they match the installed version.

## Updates and troubleshooting

Release availability and downloads are provided through Payhip. Future updates are included with the license; automatic delivery depends on the release's configured update service.

- Nothing moves: check Accessibility for both app and engine, then Resume.
- Swipes do nothing: check Controls → Trackpad, the finger count, sensitivity, and competing macOS gestures.
- Paused intentionally: choose Resume. Pause stays paused.
- Unexpected engine exits: Glidro retries up to five times in a 120-second window, then requires manual Resume.
- Hidden-window corners: macOS can retain narrow offscreen remnants, usually masked by Glidro in focused scrolling layouts.
- Still stuck: use Help or contact [Glidro support](mailto:support@glidro.app), including macOS version, Glidro version, affected app and steps to reproduce.