Back to Home

Rapto Documentation

Learn how to organize your windows efficiently with Rapto. This guide covers all features and settings to help you get the most out of the app.

Getting Started

Installation

  1. Download Rapto from the website and open the DMG file
  2. Drag Rapto to your Applications folder
  3. Launch Rapto — it will appear in your menu bar

Required Permissions

Rapto needs two permissions to work properly:

  • Accessibility — Allows Rapto to move and resize windows. Without this, the app cannot manage your windows.
  • Screen Recording — Allows Rapto to see window titles and generate previews. Your screen is never recorded or uploaded.

When prompted, grant the permissions and restart Rapto if needed. You can always manage permissions in System Settings → Privacy & Security.

Disable macOS Window Tiling and Stage Manager

macOS Sequoia and later includes built-in window tiling, and macOS also has Stage Manager. Both can conflict with Rapto. If either is on, Rapto tells you during setup and in Settings → General, with a button that opens the right page in System Settings. You can also turn them off yourself:

  1. Open System Settings → Desktop & Dock
  2. Scroll down to the Windows section
  3. Disable these options:
  • Drag windows to left or right edge of screen to tile
  • Drag windows to menu bar to fill screen
  • Hold ⌥ key while dragging windows to tile

Also turn off Stage Manager in System Settings → Desktop & Dock → Desktop & Stage Manager.

If these options stay on, macOS and Rapto may fight over window positions, and dragged windows can jump around. Rapto shows an orange warning in Settings → General until they're off. Rapto never changes these settings for you.

First Launch

After launching, you'll see the Rapto icon in your menu bar. Click it to access settings, change modes, or select templates. Press ⌃+⌥+G to open the overlay and start organizing your windows.

During setup you choose how you like to arrange windows: Drag to Snap, Manual or Auto-tiling. If you pick Auto-tiling, you also choose how many windows to keep on screen (2–8). Rapto recommends 4 for laptops and regular monitors, and 5 for wide displays. You can change it anytime in Settings.

Operating Modes

Rapto offers three different ways to manage your windows. You can choose a different mode for each monitor and each macOS Space.

Manual Mode

Pick a layout or create your own, and Rapto does the rest. Choose a layout from the menu bar or the Desktops Bar, or draw one in the overlay, and your windows move into its slots. Want a window in a different slot? Drag it onto another window to group them, or hold Control to swap them (see Window Swap). You can also drop it into an empty slot or use the Swap hotkeys.

Best for: People who want to choose or design the layout themselves and let Rapto do the arranging.

Auto Tiling

Windows automatically arrange themselves as you open or close them. The layout adapts based on how many windows you have. You can set the maximum number of tiled windows (2-8). When there are more windows than that, the extra ones stack into a group: a window joins the slot of its own app, or the last slot if its app has none. Settings windows and small pop-ups of your apps stay out of the layout.

Windows keep their place. When a window opens or closes, the others move as little as possible, and a new window takes the free spot right away. If the new window switches to a layout with one large slot, like one large and two small, or a large center among four, the new window takes the large slot and the others move to the smaller ones. To rearrange, drag a window onto another one and they swap places. If you drop a window anywhere else, it goes back to its slot. If you resize windows by hand, Rapto keeps those sizes until the number of windows changes.

Best for: Users who want hands-off window management, similar to i3 or yabai.

Drag to Snap

Drag a window and drop it into a zone. A preview appears before you release, showing where the window will go. Each desktop has its own Drag to Snap layout, separate from Manual: choose it by right-clicking the desktop in the Desktops Bar, or in the menu bar menu.

Standard Zones (the default) snap at the screen edges:

  • • Left or right edge — half of the screen
  • • Top edge — full screen
  • • Corners — a quarter of the screen
  • • Bottom edge — the left, center or right third, depending on where you drop

As soon as you start dragging, a panel with small layouts appears at the top of the screen: halves side by side, halves top and bottom, thirds, two thirds and one third (both ways), quarters, a half with two quarters, and full screen. Drop the window on any part of a layout to put it there.

With a layout, its zones work as in Manual mode: all zones show up while you drag, and the window goes into the zone under the pointer, anywhere on the screen.

Hold ⌥ while dragging to move the window freely without snapping, with Standard Zones and with a layout. With Standard Zones, the layout panel hides too.

Drop a window into a zone that already has a snapped window, and they become a group with a badge, just like in Manual mode. Resize one window of the group and the others take the same size. Drag a snapped window away and it gets back its previous size.

Best for: Users who prefer mouse-based interaction, similar to Rectangle or Magnet.

Change modes from the menu bar icon, the Desktops Bar, or Settings. Each monitor and Space can have its own mode.

Desktops Bar

The Desktops Bar sits in the middle of the menu bar. It shows your desktops by number, with an icon for each app open on that desktop. Turn it on or off in Settings → General → Menu Bar.

The Desktops Bar works on macOS 26 and later. It needs "Displays have separate Spaces" to be on in System Settings → Desktop & Dock.

Switching Desktops

Click a number to go straight to that desktop, with no slide animation. Click an app icon to open that app on its desktop.

Desktop Order

By default, macOS moves the desktop you used last next to the one you are on. For example, after you open a notification that takes you to desktop 1, the desktop you just left can become desktop 2, and the others shift to the right. The Desktops Bar shows the order macOS uses, so the numbers change too. Each desktop keeps its mode and layout wherever it moves.

To keep your desktops in a fixed order, turn off "Automatically rearrange Spaces based on most recent use" in System Settings → Desktop & Dock → Mission Control.

Bar Style

Choose how the bar looks with Style in Settings → Appearance → Desktops Bar:

  • • Dark — A dark pill on any wallpaper (the default)
  • • Glass — A see-through pill that goes light or dark with the menu bar
  • • Plain — No pill. Your desktops look like the other items in the menu bar

On a screen with a notch, the bar always uses the Dark style.

Moving Windows Between Desktops

Drag an app icon onto another desktop number to move that app's window there. You stay on the desktop you were on.

You can also use the keyboard: ⌃+⌥+⇧+← / → sends the active window to the previous or next desktop, and ⌃+⌥+⇧+1-9 sends it straight to that desktop (see Keyboard Shortcuts). It works with desktops on the same display. If there is no such desktop, you hear a beep.

  • • Hold ⌥ as you drop the icon to switch to that desktop along with the window.
  • • To make going along the default, turn on Go With Moved Window in Settings → General → Menu Bar. Then ⌥ keeps you where you are. The keyboard shortcuts follow this setting too, even when the Desktops Bar is hidden.
  • • On a Manual desktop, a window that comes back snaps into the slot it had before, or into a free one. The other windows stay where they are.

While a window is moving, the screen may briefly flash to the other desktop and back. That's how macOS moves windows between desktops.

Adding a Desktop

Click the + button at the end of the bar to add a desktop. Drop an app icon on + to add a desktop and move that app's window onto it.

Mission Control opens for a moment while the desktop is added, then closes by itself.

Desktop Menu

Right-click a desktop to choose its mode (Manual, Auto Tiling or Drag to Snap) and layout, open the overlay, restore the layout, or open Settings. While the Desktops Bar is on, the Rapto menu bar icon is hidden, since the bar has the same controls. You can bring the icon back in Settings → General → Menu Bar.

MacBooks with a Notch

On a screen with a notch, the bar stays hidden. Point at the notch and it drops down below it. Move away and it hides again. It also shows for a moment when you switch desktops. Choose how it appears with Show Desktops Bar in Settings → General → Menu Bar:

  • • Always On — Always shown. On screens with a notch it sits just below the menu bar
  • • Auto-Hide — Hidden on every screen until you point at the middle of the menu bar or the notch
  • • Notched Screens (the default) — Hidden on screens with a notch until you point at the notch, always shown on other screens

Multiple Monitors

Each display gets its own bar with its own desktops.

Keyboard Shortcuts

Rapto is designed for keyboard-first usage. Choose between two presets or customize every shortcut in Settings.

Hotkey Presets

Rapto offers two built-in presets. Switch between them in Settings → Shortcuts.

Rapto Style

Arrow-based navigation. Intuitive for most users. Uses ⌃+⌥ as base modifier.

Vim Style

HJKL navigation. Familiar for Vim/i3/yabai users. Uses ⌥ as base modifier.

Core Shortcuts (Rapto Style)

Open/Close Overlay⌃+⌥+G
Window Switcher⌃+⌥+W
Focus Window (expand/restore)⌃+⌥+F
Toggle Floating Window⌃+⌥+T
Restore Layout⌃+⌥+R
Cycle Window Group⌃+Tab

Window Navigation

Move focus between tiled windows:

Focus Left / Right / Up / Down⌃+⌥+Arrow
Swap Left / Right / Up / Down⌃+⇧+Arrow
Move to Slot Left / Right / Up / Down⌥+⇧+Arrow

Window Resize

Shrink / Grow Width⌃+⌥+H / L
Shrink / Grow Height⌃+⌥+K / J

Focus Slots

Jump directly to a window in a specific slot:

Focus Slot 1-9⌃+⇧+1-9

Multi-Monitor

Move Window to Left Monitor⌃+⌥+⌘+←
Move Window to Right Monitor⌃+⌥+⌘+→

Move Window to Desktop

Send the active window to another desktop on the same display:

Move to Previous / Next Desktop⌃+⌥+⇧+← / →
Move to Desktop 1-9⌃+⌥+⇧+1-9

In Vim Style, previous and next use the same keys, and desktops 1-9 are ⌃+⌥+1-9. Change them in Settings → Shortcuts → Move Window to Desktop.

Mode Switching

Cycle Layout Mode⌃+⌥+M

Cycles through operating modes. You can also switch modes from the menu bar icon.

All shortcuts can be customized in Settings → Shortcuts. You can also disable shortcuts for specific apps using Passthrough Apps.

Layout Templates

Templates define how your screen is divided into zones. Rapto comes with built-in templates and lets you create your own.

Built-in Templates

Full

Single window fullscreen

Halves Vertical

Two equal columns

Halves Horizontal

Two equal rows

Thirds

Three equal columns

Quarters

Four equal quadrants

1+2 Left

Large left, two stacked right

1+2 Right

Two stacked left, large right

Center Focus

Centered main window

Center Wide

Wide center with narrow side columns

…and 5 more, including 4 Columns, 2+1+2 and Center + Split Sides.

Creating Custom Templates

Draw it in the overlay

  1. Open the overlay (press ⌃+⌥+G)
  2. Click the "Custom" button in the template picker
  3. Draw zones by clicking and dragging on the grid
  4. Click a zone you already placed to move or resize it again. Double-click a zone to delete it
  5. Name your template and save it

Or arrange real windows first

  1. Place and size your windows on the display the way you want them
  2. Right-click that display's desktop in the Desktops Bar (or open the Rapto menu) and choose Create Layout from Windows
  3. Name it, or keep the suggested "Layout" with the date and time. Each window on that display becomes a zone, and the new layout appears in the template picker

Only the places are saved, not the windows or apps. To bring back the apps themselves, use Workspaces.

Custom templates are saved automatically and appear alongside built-in templates. You can rename or delete them from the template picker. Don't need a built-in layout? Point at it in the template picker and click Hide. Hidden layouts wait at the end of the picker, where Unhide brings them back.

Features

Window Switcher

Press ⌃+⌥+W (⌥+W in Vim Style) to open a search box with every open window on every desktop and display, the most recently used at the top. Start typing and the list narrows with each letter.

  • • One letter is enough. Type t to see Telegram, Terminal and any window whose title has a word starting with T. App names come first, then window titles.
  • • Shortcuts for long names. tg finds Telegram, vsc finds Visual Studio Code.
  • • Pick a window with ↑ / ↓ or Tab and press Return, press ⌘+1-9 for that row, or click it.
  • • Back to the last window: right after opening, the previous window is already selected, so Return takes you back to it.
  • • If the window is on another desktop, Rapto switches there for you. Esc closes the search.

Change the shortcut to any key combination you like in Settings → Shortcuts → Window Focus. Minimized windows and windows of hidden apps are not listed.

Workspaces

A workspace remembers the apps you use for one task and where each window goes, on every display. Arrange them once, save, and bring the whole set back whenever you need it.

  • • Save: right-click the desktop in the desktops bar and choose Workspaces → Save as Workspace…, then give it a name like “Work”. Saving again with the same name replaces it.
  • • Open: pick the workspace in the same menu. Apps that are closed are launched, and every window moves into its place, minimized ones too. A desktop in a layout switches to Manual mode with that layout.
  • • Open in New Desktop creates a fresh desktop and opens the workspace there. If the desktop you are on already has other windows, Rapto asks whether to open the workspace in a new desktop instead, separately for each display.
  • • Close Workspace closes all of its windows at once, even on another desktop, so you can move on to the next task. Unsaved work asks to be saved first.
  • • A display is missing? If a workspace was saved with a display that is not connected now, Rapto asks whether to open those apps on the display you have or to leave them out.

Rename, delete and open workspaces in Settings → Workspaces or from the Rapto menu. Apps that already have windows on another desktop stay there, and apps open with their usual window: tabs and documents are not reopened.

Multi-Monitor Support

Each monitor can have its own layout template and operating mode. Windows can be moved between monitors using ⌃+⌥+⌘+← / → or by dragging.

Per-monitor settings are saved automatically and restored when you reconnect displays. If you change the screen resolution or the Dock's size, your windows move to their places on the new size by themselves.

Window Groups

Place multiple windows in the same zone. They stack on top of each other, and you can cycle through them with a keyboard shortcut. Great for keeping related windows together. Groups work in every mode. In Manual mode, place windows in one slot. In Drag to Snap, drop a window into a zone that already has one. In Auto Tiling, windows beyond the maximum join the slot of their app, or the last slot.

A zone with stacked windows shows a group badge in its corner, with one icon for each window.

  • • Click an icon to switch straight to that window. Icons stay in place and the active one is highlighted.
  • • Scroll over the badge to move through the windows: up goes to the window on the left, down to the one on the right. Turn this off with Scroll to Cycle in Settings.
  • • Drag the badge aside if it covers buttons in your window. It slides back to its corner a couple of seconds after you move the pointer away.
  • • To hide all badges at once, use the Toggle Group Indicators shortcut in Settings → Shortcuts.

Window Swap

Instantly swap the positions of two windows. Use the keyboard shortcut, or drag one window onto another while holding Control. In Settings → General you can make dragging swap without a key; then hold Shift to group instead. In Auto Tiling, just drop one window onto another.

Focus Window

Temporarily expand any window to fullscreen (or a custom focus zone) with a single shortcut. Press again to return to the original position.

In Auto Tiling, opening or closing a window ends focus mode and puts the window back in its spot. Switching desktops and coming back keeps it as you left it.

Mouse shortcut: Hold ⌥ and double-click any window to toggle focus mode. The modifier key can be changed in Settings.

Snap Back & Restore Layout

Snap Back: If you accidentally move a tiled window, it automatically returns to its assigned zone. This keeps your layout intact without manual correction.

Restore Layout: Press ⌃+⌥+R to restore all windows to their saved positions. Useful after major layout disruptions.

Resize Adjacent

In Manual mode, drag the edge of a window and its neighbors follow as you drag, filling the space. No overlaps.

  • • The whole slot resizes, including the windows of a group hidden behind the front one.
  • • Spacing stays the same: the gap between windows is kept, including the spacing drawn in your own layouts.
  • • Windows don't get smaller than their app allows. Some apps have a minimum window size. When a window in a slot, or any window of its group, reaches it, the edge stops there. The first time, the edge goes back to where the window fits when you let go; after that it stops right at that size. This works both horizontally and vertically.

Floating Windows

Exclude specific windows from tiling. They'll float freely above your tiled layout and stay on top. Toggle with keyboard shortcut ⌃+⌥+T. In Auto Tiling, the other windows fill its space right away. Turn floating off and, if no window was opened or closed in the meantime, every window goes back to where it was.

Mouse shortcut: Hold ⌥+⌘ and double-click any window to toggle floating mode. This feature can be enabled in Settings → Appearance → Floating Windows.

Per-Space Layouts

Each macOS Space can have its own layout. Switch between Spaces and Rapto remembers which template you were using. Great for separating work contexts.

Settings

Access Settings from the menu bar icon → Settings, by right-clicking a desktop in the Desktops Bar, or press ⌘+, when the overlay is open.

General

  • • Launch at Login — Start Rapto automatically when you log in
  • • Desktops Bar — Show your desktops and their apps in the menu bar
  • • Show Desktops Bar — Always On, Auto-Hide or Notched Screens (see Desktops Bar)
  • • Menu Bar Icon — Show the Rapto icon while the Desktops Bar is on
  • • Go With Moved Window — Go to the desktop you move a window to, by dragging or with a shortcut. Hold Option while dragging to do the opposite
  • • Window Gap — Space between tiled windows (0-20 pixels)
  • • Screen Edge Gap — Space from screen edges (0-20 pixels)
  • • Settings File — Export… saves your settings, shortcuts, layouts and workspaces to one file. Import… loads them back, on this Mac or another one, and restarts Rapto. Your current settings are kept as a backup, which Show Backups opens. On another Mac, choose a layout for each desktop after the import

Apps

  • • Ignored Apps — Apps that are never managed by Rapto (e.g., system dialogs, utilities)
  • • Passthrough Apps — Apps where Rapto's shortcuts are disabled (e.g., games, virtual machines)

Shortcuts

  • • Preset — Choose between Rapto Style (arrows) or Vim Style (HJKL)
  • • Custom Bindings — Override any shortcut with your preferred key combination. Any key works, including F1–F12 (these can be used on their own, without a modifier) and keypad keys, on any keyboard layout
  • • Focus Slots 1-9 — Quickly jump to windows in specific grid positions

Focus Mode & Floating

  • • Focus Mode — Enable/disable the focus window feature
  • • Focus Zone — Set a custom zone for focused windows (instead of fullscreen)
  • • Double-Tap Modifier — Choose modifier key for mouse double-tap activation (Option by default)
  • • Floating Double-Tap — Enable Option+Command+double-tap to toggle floating windows. The key can be changed

Appearance

  • • Theme — System, Light or Dark for the Settings window. System follows your Mac
  • • Desktops Bar Style — Dark, Glass or Plain (see Desktops Bar)
  • • Highlight Active Window — Show a colored border around the focused window. The border hides while you resize a window and comes back when you let go
  • • Border Color — The color of the border around the focused window. The current desktop in the Desktops Bar is outlined in the same color
  • • Show Zone Previews — Display zone outlines when dragging windows
  • • Group Indicators — Show/hide indicators for stacked window groups

Most settings take effect immediately. Some (like permissions) may require restarting Rapto.

Troubleshooting

Rapto doesn't move my windows

Make sure Accessibility permission is granted in System Settings → Privacy & Security → Accessibility. If already granted, try removing Rapto from the list and adding it again, then restart the app.

Window previews aren't showing

Grant Screen Recording permission in System Settings → Privacy & Security → Screen Recording. Restart Rapto after granting permission.

Hotkeys don't work in a specific app

Some apps (like games or VMs) capture all keyboard input. Add them to the "Passthrough Apps" list in Settings → Apps to prevent conflicts.

Windows jump around when switching Spaces

This can happen briefly during Space transitions. If it persists, try disabling Auto Tiling for that Space.

Windows jump when I drag them

macOS window tiling and Stage Manager can fight with Rapto. If either is on, Settings → General shows an orange warning. Click Open Settings… and turn off the switches it lists in System Settings → Desktop & Dock → Windows, and Stage Manager in Desktop & Stage Manager.

The Desktops Bar doesn't appear

Check that it's on in Settings → General → Menu Bar and that "Displays have separate Spaces" is on in System Settings → Desktop & Dock. On a MacBook with a notch, point at the notch, or set Show Desktops Bar to Always On.

My desktops changed their order

macOS does this, not Rapto: it moves recently used desktops closer to the one you are on. Turn off "Automatically rearrange Spaces based on most recent use" in System Settings → Desktop & Dock → Mission Control. Rapto keeps each desktop's mode and layout either way.

How do I report a bug?

Enable Debug Logging in Settings → About → Troubleshooting. Reproduce the issue, then click "Open Log Folder" and send the logs to support@rapto.app.

Need more help?

Contact us at support@rapto.app